<titledata-rh="true">Configuration 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.configuration"><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="Configuration interface | Puppeteer"><metadata-rh="true"name="description"content="Defines options to configure Puppeteer's behavior during installation and runtime."><metadata-rh="true"property="og:description"content="Defines options to configure Puppeteer's behavior during installation and runtime."><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://pptr.dev/api/puppeteer.configuration"><linkdata-rh="true"rel="alternate"href="https://pptr.dev/api/puppeteer.configuration"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://pptr.dev/api/puppeteer.configuration"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>Defines options to configure Puppeteer's behavior during installation and runtime.</p>
<p>See individual properties for more information.</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>browserRevision</td><td><code>optional</code></td><td>string</td><td><p>Specifies a certain version of the browser you'd like Puppeteer to use.</p><p>Can be overridden by <code>PUPPETEER_BROWSER_REVISION</code>.</p><p>See <ahref="/api/puppeteer.puppeteernode.launch">puppeteer.launch</a> on how executable path is inferred.</p></td><td>A compatible-revision of the browser.</td></tr><tr><td>cacheDirectory</td><td><code>optional</code></td><td>string</td><td><p>Defines the directory to be used by Puppeteer for caching.</p><p>Can be overridden by <code>PUPPETEER_CACHE_DIR</code>.</p></td><td><code>path.join(os.homedir(), '.cache', 'puppeteer')</code></td></tr><tr><td>defaultProduct</td><td><code>optional</code></td><td><ahref="/api/puppeteer.product">Product</a></td><td><p>Specifies which browser you'd like Puppeteer to use.</p><p>Can be overridden by <code>PUPPETEER_PRODUCT</code>.</p></td><td><code>chrome</code></td></tr><tr><td>downloadBaseUrl</td><td><code>optional</code></td><td>string</td><td><p>Specifies the URL prefix that is used to download the browser.</p><p>Can be overridden by <code>PUPPETEER_DOWNLOAD_BASE_URL</code>.</p></td><td>Either <ahref="https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing"target="_blank"rel="noopener noreferrer">https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing</a> or <ahref="https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central"target="_blank"rel="noopener noreferrer">https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central</a>, depending on the product.</td></tr><tr><td>downloadPath</td><td><code>optional</code></td><td>string</td><td><p>Specifies the path for the downloads folder.</p><p>Can be overridden by <code>PUPPETEER_DOWNLOAD_PATH</code>.</p></td><td><code><cacheDirectory></code></td></tr><tr><td>executablePath</td><td><code>optional</code></td><td>string</td><td><p>Specifies an executable path to be used in <ahref="/api/puppeteer.puppeteernode.launch">puppeteer.launch</a>.</p><p>Can be overridden by <code>PUPPETEER_EXECUTABLE_PATH</code>.</p></td><td><strong>Auto-computed.</strong></td></tr><tr><td>experiments</td><td><code>optional</code></td><td><ahref="/api/puppeteer.experimentsconfiguration">ExperimentsConfiguration</a></td><td>Defines experimental options for Puppeteer.</td><td></td></tr><tr><td>logLevel</td><td><code>optional</code></td><td>'silent' | 'error' | 'warn'</td><td>Tells Puppeteer to log at the given level.</td><td><code>warn</code></td></tr><tr><td>skipChromeDownload</td><td><code>optional</code></td><td>boolean</td><td><p>Tells Puppeteer to not Chrome download during installation.</p><p>Can be overridden by <code>PUPPETEER_SKIP_CHROME_DOWNLOAD</code>.</p></td><td></td></tr><tr><td>skipChromeHeadlessShellDownload</td><td><code>optional</code></td><td>boolean</td><td><p>Tells Puppeteer to not chrome-headless-shell download during installation.</p><p>Can be overridden by <code>PUPPETEER_SKIP_CHROME_HEADLESSS_HELL_DOWNLOAD</code>.</p></td><td></td></tr><tr><td>skipDownload</td><td><code>optional</code></td><td>boolean</td><td><p>Tells Puppeteer to not download during installation.</p><p>Can be overridden by <code>PUPPETEER_SKIP_DOWNLOAD</code>.</p></td><td></td></tr><tr><td>temporaryDirectory</td><td><code>optional</code></td><td>string</td><td><p>Defines the directory to be used by Puppeteer for creating temporary files.</p><p>Can be overridden by <code>PUPPETEER_TMP_DIR</code>.</p></td><td><code>os.tmpdir()</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.commoneventemitter.removelistener"><divclass="pagination-nav__sublabel">Previous</div><divclass="pagination-nav__label">CommonEventEmitter.removeListener</div></a><aclass="pagination-nav__linkpagination-nav__lin
