Skip to main content
Version: 3.10

BrowserPluginOptions <LibraryOptions>

Hierarchy

Index

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 = ```ts 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.