Class BrowserAbstract

Browser represents a browser instance that is either:

  • connected to via Puppeteer.connect or
  • launched by PuppeteerNode.launch.

Browser emits various events which are documented in the BrowserEvent enum.

Example: Using a {@link Browser} to create a {@link Page}:

import puppeteer from 'puppeteer';

const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

Example: Disconnecting from and reconnecting to a {@link Browser}:

import puppeteer from 'puppeteer';

const browser = await puppeteer.launch();
// Store the endpoint to be able to reconnect to the browser.
const browserWSEndpoint = browser.wsEndpoint();
// Disconnect puppeteer from the browser.
await browser.disconnect();

// Use the endpoint to reestablish a connection
const browser2 = await puppeteer.connect({browserWSEndpoint});
// Close the browser.
await browser2.close();

Hierarchy

  • EventEmitter<BrowserEvents>
    • Browser

Constructors

constructor

Accessors

connected debugInfo

Methods

browserContexts close createBrowserContext defaultBrowserContext disconnect emit isConnected listenerCount newPage off on once pages process removeAllListeners target targets userAgent version waitForTarget wsEndpoint

Constructors

constructor

  • new Browser(): Browser

  • Returns Browser

Accessors

Abstractconnected

  • get connected(): boolean

  • Whether Puppeteer is connected to this browser.

    Returns boolean

AbstractdebugInfo

  • get debugInfo(): DebugInfo
  • Experimental

    Get debug information from Puppeteer.

    Returns DebugInfo

    Remarks

    Currently, includes pending protocol calls. In the future, we might add more info.

Methods

AbstractbrowserContexts

  • browserContexts(): BrowserContext[]

  • Gets a list of open BrowserContext | browser contexts.

    In a newly-created browser, this will return a single instance of BrowserContext.

    Returns BrowserContext[]

Abstractclose

  • close(): Promise<void>

  • Closes this browser and all associated pages.

    Returns Promise<void>

AbstractcreateBrowserContext

  • createBrowserContext(options?): Promise<BrowserContext>

  • Creates a new BrowserContext | browser context.

    This won't share cookies/cache with other BrowserContext | browser contexts.

    Parameters

    • Optionaloptions: BrowserContextOptions

    Returns Promise<BrowserContext>

    Example

    import puppeteer from 'puppeteer';

    const browser = await puppeteer.launch();
    // Create a new browser context.
    const context = await browser.createBrowserContext();
    // Create a new page in a pristine context.
    const page = await context.newPage();
    // Do stuff
    await page.goto('https://example.com');

AbstractdefaultBrowserContext

  • defaultBrowserContext(): BrowserContext

  • Gets the default BrowserContext | browser context.

    Returns BrowserContext

    Remarks

    The default BrowserContext | browser context cannot be closed.

Abstractdisconnect

  • disconnect(): Promise<void>

  • Disconnects Puppeteer from this browser, but leaves the process running.

    Returns Promise<void>

emit

  • emit<Key>(type, event): boolean

  • Emit an event and call any associated listeners.

    Type Parameters

    • Key extends keyof BrowserEvents

    Parameters

    • type: Key

      the event you'd like to emit

    • event: EventsWithWildcard<BrowserEvents>[Key]

    Returns boolean

    true if there are any listeners, false if there are not.

isConnected

  • isConnected(): boolean

  • Whether Puppeteer is connected to this browser.

    Returns boolean

    Deprecated

    Use Browser.connected.

listenerCount

  • listenerCount(type): number

  • Gets the number of listeners for a given event.

    Parameters

    • type: keyof BrowserEvents

      the event to get the listener count for

    Returns number

    the number of listeners bound to the given event

AbstractnewPage

off

  • off<Key>(type, handler?): this

  • Remove an event listener from firing.

    Type Parameters

    • Key extends keyof BrowserEvents

    Parameters

    • type: Key

      the event type you'd like to stop listening to.

    • Optionalhandler: Handler<EventsWithWildcard<BrowserEvents>[Key]>

      the function that should be removed.

    Returns this

    this to enable you to chain method calls.

on

  • on<Key>(type, handler): this

  • Bind an event listener to fire when an event occurs.

    Type Parameters

    • Key extends keyof BrowserEvents

    Parameters

    • type: Key

      the event type you'd like to listen to. Can be a string or symbol.

    • handler: Handler<EventsWithWildcard<BrowserEvents>[Key]>

      the function to be called when the event occurs.

    Returns this

    this to enable you to chain method calls.

once

  • once<Key>(type, handler): this

  • Like on but the listener will only be fired once and then it will be removed.

    Type Parameters

    • Key extends keyof BrowserEvents

    Parameters

    • type: Key

      the event you'd like to listen to

    • handler: Handler<EventsWithWildcard<BrowserEvents>[Key]>

      the handler function to run when the event occurs

    Returns this

    this to enable you to chain method calls.

pages

  • pages(): Promise<Page[]>

  • Gets a list of all open pages inside this Browser.

    If there ar multiple BrowserContext | browser contexts, this returns all pages in all BrowserContext | browser contexts.

    Returns Promise<Page[]>

    Remarks

    Non-visible pages, such as "background_page", will not be listed here. You can find them using Target.page.

Abstractprocess

  • process(): null | ChildProcess

  • Gets the associated ChildProcess.

    Returns null | ChildProcess

    null if this instance was connected to via Puppeteer.connect.

removeAllListeners

  • removeAllListeners(type?): this

  • Removes all listeners. If given an event argument, it will remove only listeners for that event.

    Parameters

    • Optionaltype: keyof BrowserEvents

      the event to remove listeners for.

    Returns this

    this to enable you to chain method calls.

Abstracttarget

  • target(): Target

  • Gets the Target | target associated with the default browser context).

    Returns Target

Abstracttargets

  • targets(): Target[]

  • Gets all active Target | targets.

    In case of multiple BrowserContext | browser contexts, this returns all Target | targets in all BrowserContext | browser contexts.

    Returns Target[]

AbstractuserAgent

  • userAgent(): Promise<string>

  • Gets this browser's original user agent.

    Pages can override the user agent with Page.setUserAgent.

    Returns Promise<string>

Abstractversion

  • version(): Promise<string>

  • Gets a string representing this browser's name and version.

    For headless browser, this is similar to "HeadlessChrome/61.0.3153.0". For non-headless or new-headless, this is similar to "Chrome/61.0.3153.0". For Firefox, it is similar to "Firefox/116.0a1".

    The format of Browser.version might change with future releases of browsers.

    Returns Promise<string>

waitForTarget

  • waitForTarget(predicate, options?): Promise<Target>

  • Waits until a Target | target matching the given predicate appears and returns it.

    This will look all open BrowserContext | browser contexts.

    Parameters

    • predicate: ((x: Target) => boolean | Promise<boolean>)
        • (x): boolean | Promise<boolean>

        • Parameters

          • x: Target

          Returns boolean | Promise<boolean>

    • Optionaloptions: WaitForTargetOptions

    Returns Promise<Target>

    Example: Finding a target for a page opened via `window.open`:

    await page.evaluate(() => window.open('https://www.example.com/'));
    const newWindowTarget = await browser.waitForTarget(
      target => target.url() === 'https://www.example.com/'
    );

AbstractwsEndpoint

  • wsEndpoint(): string

  • Gets the WebSocket URL to connect to this browser.

    This is usually used with Puppeteer.connect.

    You can find the debugger URL (webSocketDebuggerUrl) from http://HOST:PORT/json/version.

    See browser endpoint for more information.

    Returns string

    Remarks

    The format is always ws://HOST:PORT/devtools/browser/<id>.

Settings

Member Visibility

On This Page

Constructors
Accessors
Methods