website/versioned_docs/version-24.40.0/api/puppeteer.connectoptions.md
Generic browser options that can be passed when launching any browser or when connecting to an existing browser instance.
export interface ConnectOptions
Property
</th><th>Modifiers
</th><th>Type
</th><th>Description
</th><th>Default
</th></tr></thead> <tbody><tr><td><span id="acceptinsecurecerts">acceptInsecureCerts</span>
</td><td>optional
boolean
</td><td>Whether to ignore HTTPS errors during navigation.
</td><td>false
<span id="browserurl">browserURL</span>
</td><td>optional
string
</td><td> </td><td> </td></tr> <tr><td><span id="browserwsendpoint">browserWSEndpoint</span>
</td><td>optional
string
</td><td> </td><td> </td></tr> <tr><td><span id="capabilities">capabilities</span>
</td><td>optional
SupportedWebDriverCapabilities
</td><td>WebDriver BiDi capabilities passed to BiDi session.new.
Remarks:
Only works for protocol="webDriverBiDi" and Puppeteer.connect().
<span id="channel">channel</span>
</td><td>optional
(Experimental) If specified, puppeteer looks for an open WebSocket at the well-known default user data directory for the specified channel and attempts to connect to it using ws://localhost:$ActivePort/devtools/browser. Only works for Chrome and when run in Node.js.
This option is experimental when used with puppeteer.connect().
</td><td> </td></tr> <tr><td><span id="defaultviewport">defaultViewport</span>
</td><td>optional
Viewport | null
</td><td>Sets the viewport for each page.
</td><td>'{width: 800, height: 600}'
</td></tr> <tr><td><span id="downloadbehavior">downloadBehavior</span>
</td><td>optional
Sets the download behavior for the context.
</td><td> </td></tr> <tr><td><span id="handledevtoolsaspage">handleDevToolsAsPage</span>
</td><td>optional
boolean
</td><td>Whether to handle the DevTools windows as pages in Puppeteer. Supported only in Chrome with CDP.
</td><td>'false'
</td></tr> <tr><td><span id="headers">headers</span>
</td><td>optional
Record<string, string>
</td><td>Headers to use for the web socket connection.
Remarks:
Only works in the Node.js environment.
</td><td> </td></tr> <tr><td><span id="networkenabled">networkEnabled</span>
</td><td>optional
boolean
</td><td>(Experimental) Experimental setting to disable monitoring network events by default. When set to false, parts of Puppeteer that depend on network events would not work such as HTTPRequest and HTTPResponse.
true
<span id="protocol">protocol</span>
</td><td>optional
Determined at run time:
Launching Chrome - 'cdp'.
Launching Firefox - 'webDriverBiDi'.
Connecting to a browser - 'cdp'.
<span id="protocoltimeout">protocolTimeout</span>
</td><td>optional
number
</td><td>Timeout setting for individual protocol (CDP) calls.
</td><td>180_000
<span id="slowmo">slowMo</span>
</td><td>optional
number
</td><td>Slows down Puppeteer operations by the specified amount of milliseconds to aid debugging.
</td><td> </td></tr> <tr><td><span id="targetfilter">targetFilter</span>
</td><td>optional
Callback to decide if Puppeteer should connect to a given target or not.
</td><td> </td></tr> <tr><td><span id="transport">transport</span>
</td><td>optional