<titledata-rh="true">LaunchOptions interface | Puppeteer</title><metadata-rh="true"name="viewport"content="width=device-width,initial-scale=1"><metadata-rh="true"name="twitter:card"content="summary_large_image"><metadata-rh="true"property="og:url"content="https://pptr.dev/api/puppeteer.launchoptions"><metadata-rh="true"property="og:locale"content="en"><metadata-rh="true"name="docsearch:language"content="en"><metadata-rh="true"name="docsearch:counter"content="2"><metadata-rh="true"property="og:title"content="LaunchOptions interface | Puppeteer"><metadata-rh="true"name="description"content="Generic launch options that can be passed when launching any browser."><metadata-rh="true"property="og:description"content="Generic launch options that can be passed when launching any browser."><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://pptr.dev/api/puppeteer.launchoptions"><linkdata-rh="true"rel="alternate"href="https://pptr.dev/api/puppeteer.launchoptions"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://pptr.dev/api/puppeteer.launchoptions"hreflang="x-default"><linkdata-rh="true"rel="preconnect"href="https://DVKY664LG7-dsn.algolia.net"crossorigin="anonymous"><linkrel="search"type="application/opensearchdescription+xml"title="Puppeteer"href="/opensearch.xml">
<p>Generic launch options that can be passed when launching any browser.</p>
<h4class="anchor anchorWithStickyNavbar_LWe7"id="signature">Signature:<ahref="#signature"class="hash-link"aria-label="Direct link to Signature:"title="Direct link to Signature:"></a></h4>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="properties">Properties<ahref="#properties"class="hash-link"aria-label="Direct link to Properties"title="Direct link to Properties"></a></h2>
<table><thead><tr><th>Property</th><th>Modifiers</th><th>Type</th><th>Description</th><th>Default</th></tr></thead><tbody><tr><td>channel</td><td><code>optional</code></td><td><ahref="/api/puppeteer.chromereleasechannel">ChromeReleaseChannel</a></td><td>Chrome Release Channel</td><td></td></tr><tr><td>dumpio</td><td><code>optional</code></td><td>boolean</td><td>If true, pipes the browser process stdout and stderr to <code>process.stdout</code> and <code>process.stderr</code>.</td><td><code>false</code></td></tr><tr><td>env</td><td><code>optional</code></td><td>Record<string, string | undefined></td><td>Specify environment variables that will be visible to the browser.</td><td>The contents of <code>process.env</code>.</td></tr><tr><td>executablePath</td><td><code>optional</code></td><td>string</td><td>Path to a browser executable to use instead of the bundled Chromium. Note that Puppeteer is only guaranteed to work with the bundled Chromium, so use this setting at your own risk.</td><td></td></tr><tr><td>extraPrefsFirefox</td><td><code>optional</code></td><td>Record<string, unknown></td><td><ahref="https://searchfox.org/mozilla-release/source/modules/libpref/init/all.js"target="_blank"rel="noopener noreferrer">Additional preferences</a> that can be passed when launching with Firefox.</td><td></td></tr><tr><td>handleSIGHUP</td><td><code>optional</code></td><td>boolean</td><td>Close the browser process on <code>SIGHUP</code>.</td><td><code>true</code></td></tr><tr><td>handleSIGINT</td><td><code>optional</code></td><td>boolean</td><td>Close the browser process on <code>Ctrl+C</code>.</td><td><code>true</code></td></tr><tr><td>handleSIGTERM</td><td><code>optional</code></td><td>boolean</td><td>Close the browser process on <code>SIGTERM</code>.</td><td><code>true</code></td></tr><tr><td>ignoreDefaultArgs</td><td><code>optional</code></td><td>boolean | string[]</td><td>If <code>true</code>, do not use <code>puppeteer.defaultArgs()</code> when creating a browser. If an array is provided, these args will be filtered out. Use this with care - you probably want the default arguments Puppeteer uses.</td><td><code>false</code></td></tr><tr><td>pipe</td><td><code>optional</code></td><td>boolean</td><td>Connect to a browser over a pipe instead of a WebSocket.</td><td><code>false</code></td></tr><tr><td>product</td><td><code>optional</code></td><td><ahref="/api/puppeteer.product">Product</a></td><td>Which browser to launch.</td><td><code>chrome</code></td></tr><tr><td>timeout</td><td><code>optional</code></td><td>number</td><td>Maximum time in milliseconds to wait for the browser to start. Pass <code>0</code> to disable the timeout.</td><td><code>30_000</code> (30 seconds).</td></tr><tr><td>waitForInitialPage</td><td><code>optional</code></td><td>boolean</td><td>Whether to wait for the initial page to be ready. Useful when a user explicitly disables that (e.g. <code>--no-startup-window</code> for Chrome).</td><td><code>true</code></td></tr></tbody></table></div></article><navclass="pagination-nav docusaurus-mt-lg"aria-label="Docs pages"><aclass="pagination-nav__link pagination-nav__link--prev"href="/api/puppeteer.launch"><divclass="pagination-nav__sublabel">Previous</div><divclass="pagination-nav__label">launch</div></a><aclass="pagination-nav__link pagination-nav__link--next"href="/api/puppeteer.locator"><divclass="pagination-nav__sublabel">Next</div><divclass="pagination-nav__label">Locator</div></a></nav></div></div><divclass="col col--3"><divclass="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ulclass="table-of-contents table-of-contents__left-border"><li><ahref="#properties"class="table-of-contents__link toc-highlight">Properties</a></li></ul></div></div></div></div></main></div></div></div><footerclass="footer footer--dark"><divclass="container container-fluid"><divclass="row footer__links"><divclass="col footer__col"><divclass="footer__title">Community</div><ulclass="footer__items clean-list"><liclass="footer__item"><ahref="https://stackoverflow.com/questions/tagged/puppeteer
