BrowserPluginOptions <LibraryOptions>

Hierarchy

• BrowserPluginOptions
  • BrowserLaunchContext

Index

Properties

• browserPerProxy
• experimentalContainers
• launchOptions
• proxyUrl
• useIncognitoPages
• userDataDir

Properties

optionalbrowserPerProxy

browserPerProxy?: boolean

If set to true, the crawler respects the proxy url generated for the given request. This aligns the browser-based crawlers with the HttpCrawler.

Might cause performance issues, as Crawlee might launch too many browser instances.

optionalexperimentalContainers

experimental

experimentalContainers?: boolean

Like useIncognitoPages, but for persistent contexts, so cache is used for faster loading. Works best with Firefox. Unstable on Chromium.

optionallaunchOptions

launchOptions?: LibraryOptions

Options that will be passed down to the automation library. E.g. puppeteer.launch(launchOptions);. This is a good place to set options that you want to apply as defaults. To dynamically override those options per-browser, see the preLaunchHooks of BrowserPool.

optionalproxyUrl

proxyUrl?: string

Automation libraries configure proxies differently. This helper allows you to set a proxy URL without worrying about specific implementations. It also allows you use an authenticated proxy without extra code.

optionaluseIncognitoPages

useIncognitoPages?: boolean = false

By default pages share the same browser context. If set to true each page uses its own context that is destroyed once the page is closed or crashes.

optionaluserDataDir

userDataDir?: string

Path to a User Data Directory, which stores browser session data like cookies and local storage.