Browser - @astral/astral

class Browser

implements AsyncDisposable

The browser class is instantiated when you run the launch method.

Examples

const browser = await launch();

new



Browser(ws: WebSocket,
process: Deno.ChildProcess | null,
opts: BrowserOptions,
)

readonly



closed: boolean

Returns true if the browser and its websocket have benn closed

readonly



isRemoteConnection: boolean

Returns true if browser is connected remotely instead of using a subprocess

readonly



pages: Page[]



[Symbol.asyncDispose](): Promise<void>



close(): Promise<void>

Closes the browser and all of its pages (if any were opened). The Browser object itself is considered to be disposed and cannot be used anymore.



disconnect(): Promise<void>

Disconnects the browser from the websocket connection. This is useful if you want to keep the browser running but don't want to use it anymore.



newPage(url?: string,
options?: WaitForOptions
 & SandboxOptions
 & UserAgentOptions,
): Promise<Page>

Promise which resolves to a new Page object.



unsafelyGetCelestialBindings(): Celestial

Returns raw celestial bindings for the browser. Super unsafe unless you know what you're doing.



userAgent(): Promise<string>

The browser's original user agent.



version(): Promise<string>

A string representing the browser name and version.



wsEndpoint(): string

The browser's websocket endpoint