NewPageOptions

Options accepted by IBrowserPool.newPage.

Hierarchy

• NewPageOptions
  • BrowserPoolNewPageOptions

Index

Properties

• id
• session

Properties

optionalid

id?: string

Assign a custom ID to the page. If you don't provide one, a random string ID is generated.

optionalsession

session?: ISession

The crawling session that will use the returned page.

The pool derives proxy configuration from the session's proxy (including TLS-error handling) — there are intentionally no standalone proxyUrl / ignoreTlsErrors options; configure them through the session instead.

Session injection is best-effort: the pool may use the session's proxy, cookies, or fingerprint data to configure the page or the underlying browser, but none of this is guaranteed. Different pool implementations (or pool configurations such as useIncognitoPages) may support different subsets of session properties — or ignore them entirely.

The crawler is still responsible for deterministic session setup (e.g. injecting cookies into the page before navigation) that must happen regardless of pool implementation.