puppeteer/docs/api/puppeteer.browserconnectoptions.md

---
sidebar_label: BrowserConnectOptions
---

# BrowserConnectOptions interface

Generic browser options that can be passed when launching any browser or when connecting to an existing browser instance.

#### Signature:

```typescript
export interface BrowserConnectOptions
```

## Properties

| Property          | Modifiers             | Type                                                        | Description                                                                               | Default                               |
| ----------------- | --------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------- |
| defaultViewport   | <code>optional</code> | [Viewport](./puppeteer.viewport.md) \| null                 | Sets the viewport for each page.                                                          | '&#123;width: 800, height: 600&#125;' |
| ignoreHTTPSErrors | <code>optional</code> | boolean                                                     | Whether to ignore HTTPS errors during navigation.                                         | <code>false</code>                    |
| protocol          | <code>optional</code> | [ProtocolType](./puppeteer.protocoltype.md)                 |                                                                                           | 'cdp'                                 |
| protocolTimeout   | <code>optional</code> | number                                                      | Timeout setting for individual protocol (CDP) calls.                                      | <code>180_000</code>                  |
| slowMo            | <code>optional</code> | number                                                      | Slows down Puppeteer operations by the specified amount of milliseconds to aid debugging. |                                       |
| targetFilter      | <code>optional</code> | [TargetFilterCallback](./puppeteer.targetfiltercallback.md) | Callback to decide if Puppeteer should connect to a given target or not.                  |                                       |
chore: format docs (#8629) 2022-07-05 13:41:43 +00:00			`---`
			`sidebar_label: BrowserConnectOptions`
			`---`

			`# BrowserConnectOptions interface`

			`Generic browser options that can be passed when launching any browser or when connecting to an existing browser instance.`

fix: update documentation on configuring puppeteer (#9150) This PR updates the docs regarding configuring puppeteer. In addition, some changes have been made to the documentation generator to show default values on the documentation site. Also fixes: https://github.com/puppeteer/puppeteer/pull/9144 2022-10-24 07:07:05 +00:00			`#### Signature:`
chore: format docs (#8629) 2022-07-05 13:41:43 +00:00
			```typescript
			`export interface BrowserConnectOptions`
			```

			`## Properties`

docs: Upgrading to Docusaurus V3 (#11434) Co-authored-by: Alex Rudenko <alexrudenko@chromium.org> 2023-11-29 12:06:05 +00:00			`\| Property \| Modifiers \| Type \| Description \| Default \|`
			`\| ----------------- \| --------------------- \| ----------------------------------------------------------- \| ----------------------------------------------------------------------------------------- \| ------------------------------------- \|`
			`\| defaultViewport \| <code>optional</code> \| [Viewport](./puppeteer.viewport.md) \\| null \| Sets the viewport for each page. \| '{width: 800, height: 600}' \|`
			`\| ignoreHTTPSErrors \| <code>optional</code> \| boolean \| Whether to ignore HTTPS errors during navigation. \| <code>false</code> \|`
			`\| protocol \| <code>optional</code> \| [ProtocolType](./puppeteer.protocoltype.md) \| \| 'cdp' \|`
			`\| protocolTimeout \| <code>optional</code> \| number \| Timeout setting for individual protocol (CDP) calls. \| <code>180_000</code> \|`
			`\| slowMo \| <code>optional</code> \| number \| Slows down Puppeteer operations by the specified amount of milliseconds to aid debugging. \| \|`
			`\| targetFilter \| <code>optional</code> \| [TargetFilterCallback](./puppeteer.targetfiltercallback.md) \| Callback to decide if Puppeteer should connect to a given target or not. \| \|`