Skip to main content
Version: Next

RemoteBrowserPoolOptions

Index

Properties

Properties

browserPlugins

browserPlugins: BrowserPlugin<CommonLibrary, undefined | Dictionary, CommonBrowser, unknown, CommonPage>[]

The browser plugin(s) used to connect to the remote service — e.g. new PlaywrightPlugin(playwright.chromium) or new PuppeteerPlugin(puppeteer). The pool configures them for remote connection; do not set a local launchOptions on them.

optionalbrowserPoolOptions

browserPoolOptions?: Omit<BrowserPoolOptions<BrowserPlugin<CommonLibrary, undefined | Dictionary, CommonBrowser, unknown, CommonPage>>, browserPlugins> & BrowserPoolHooks<any, any, any>

Extra BrowserPool options (lifecycle hooks, page limits, fingerprinting, …).

optionalconnection

connection?: RemoteConnectionParameters

Static connect() parameters (Playwright protocol selection, headers, timeouts, …).

endpoint

endpoint: RemoteBrowserProvider<any> | RemoteBrowserEndpoint

The remote browser endpoint: a static URL, a function returning one per launch, or a RemoteBrowserProvider instance encapsulating a session create/release lifecycle.

optionalmaxOpenBrowsers

maxOpenBrowsers?: number

Maximum number of remote browsers open at once. When reached, newPage waits for a browser to close before connecting a new one. Set it to your service's concurrent-session limit to avoid 429 errors. Defaults to the provider's value, or Infinity.

optionalrelease

release?: (info) => unknown

Cleanup callback invoked when a browser closes, crashes, or the pool is destroyed. Receives the context returned by a function endpoint. Errors are caught and logged. Ignored when endpoint is a RemoteBrowserProvider (its own release() is used instead).

Type declaration

    • (info): unknown

    • Parameters

      • info: { context?: Record<string, unknown>; endpoint: string }
        • optionalcontext: Record<string, unknown>
        • endpoint: string

      Returns unknown

optionalslotPollIntervalMillis

slotPollIntervalMillis?: number = 500

Fallback poll interval (ms) while waiting for a free browser slot. The wait is event-driven; this only bounds it.

Page Options