puppeteer/docs/api/puppeteer.browserlaunchargumentoptions.md

---
sidebar_label: BrowserLaunchArgumentOptions
---

# BrowserLaunchArgumentOptions interface

Launcher options that only apply to Chrome.

#### Signature:

```typescript
export interface BrowserLaunchArgumentOptions
```

## Properties

| Property      | Modifiers             | Type               | Description                                                                                                                                                   | Default            |
| ------------- | --------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| args          | <code>optional</code> | string\[\]         | Additional command line arguments to pass to the browser instance.                                                                                            |                    |
| debuggingPort | <code>optional</code> | number             | Specify the debugging port number to use                                                                                                                      |                    |
| devtools      | <code>optional</code> | boolean            | Whether to auto-open a DevTools panel for each tab. If this is set to <code>true</code>, then <code>headless</code> will be forced to <code>false</code>.     | <code>false</code> |
| headless      | <code>optional</code> | boolean \| 'shell' | Whether to run the browser in headless mode.                                                                                                                  | <code>true</code>  |
| userDataDir   | <code>optional</code> | string             | Path to a user data directory. [see the Chromium docs](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/user_data_dir.md) for more info. |                    |
chore: format docs (#8629) 2022-07-05 13:41:43 +00:00			`---`
			`sidebar_label: BrowserLaunchArgumentOptions`
			`---`

			`# BrowserLaunchArgumentOptions interface`

			`Launcher options that only apply to Chrome.`

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 BrowserLaunchArgumentOptions`
			```

			`## Properties`

refactor!: enable the new-headless mode by default (#11815) 2024-02-02 12:25:43 +00:00			`\| Property \| Modifiers \| Type \| Description \| Default \|`
			`\| ------------- \| --------------------- \| ------------------ \| ------------------------------------------------------------------------------------------------------------------------------------------------------------- \| ------------------ \|`
			`\| args \| <code>optional</code> \| string\[\] \| Additional command line arguments to pass to the browser instance. \| \|`
			`\| debuggingPort \| <code>optional</code> \| number \| Specify the debugging port number to use \| \|`
			`\| devtools \| <code>optional</code> \| boolean \| Whether to auto-open a DevTools panel for each tab. If this is set to <code>true</code>, then <code>headless</code> will be forced to <code>false</code>. \| <code>false</code> \|`
			`\| headless \| <code>optional</code> \| boolean \\| 'shell' \| Whether to run the browser in headless mode. \| <code>true</code> \|`
			`\| userDataDir \| <code>optional</code> \| string \| Path to a user data directory. [see the Chromium docs](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/user_data_dir.md) for more info. \| \|`