Browser

Pre-built launcher handles for the two supported browsers.

const chromium: BrowserType
const firefox: BrowserType

import { firefox } from "@allwright.dev/core";
const browser = await firefox.launch();

Launches a browser session of this type. launchChrome()/launchFirefox() are equivalent shortcuts.

launch(options?: LaunchOptions): Promise<Browser>

Returns the browser's initial page. initialPage()/initialTab() are aliases.

page(): Page

const page = browser.page();

Opens and returns a new page in the same browser session. pages() lists every page tracked so far; newTab() is an alias.

newPage(options?: CommandOptions): Promise<Page>

Closes the browser session and disposes all its pages.

close(): Promise<void>

Launch-time options: a custom browser binary path and a launch timeout.

type LaunchOptions = {
  browserBinary?: string;
  timeoutMs?: number;
}