<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">
<h4class="anchor anchorWithStickyNavbar_FNw8"id="signature">Signature:<aclass="hash-link"aria-label="Direct link to Signature:"title="Direct link to Signature:"href="/api/puppeteer.configuration#signature"></a></h4>
<h2class="anchor anchorWithStickyNavbar_FNw8"id="properties">Properties<aclass="hash-link"aria-label="Direct link to Properties"title="Direct link to Properties"href="/api/puppeteer.configuration#properties"></a></h2>
<table><thead><tr><th><p>Property</p></th><th><p>Modifiers</p></th><th><p>Type</p></th><th><p>Description</p></th><th><p>Default</p></th></tr></thead><tbody><tr><td><spanid="browserrevision">browserRevision</span></td><td><p><code>optional</code></p></td><td><p>string</p></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><p>Use a specific browser version (e.g., 119.0.6045.105). If you use an alias such <code>stable</code> or <code>canary</code> it will only work during the installation of Puppeteer and it will fail when launching the browser.</p></td><td><p>The pinned browser version supported by the current Puppeteer version.</p></td></tr><tr><td><spanid="cachedirectory">cacheDirectory</span></td><td><p><code>optional</code></p></td><td><p>string</p></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><p><code>path.join(os.homedir(), '.cache', 'puppeteer')</code></p></td></tr><tr><td><spanid="defaultproduct">defaultProduct</span></td><td><p><code>optional</code></p></td><td><p><ahref="/api/puppeteer.product">Product</a></p></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><p><code>chrome</code></p></td></tr><tr><td><spanid="downloadbaseurl">downloadBaseUrl</span></td><td><p><code>optional</code></p></td><td><p>string</p></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><p><strong>Remarks:</strong></p><p>This must include the protocol and may even need a path prefix.</p></td><td><p>Either <ahref="https://storage.googleapis.com/chrome-for-testing-public"target="_blank"rel="noopener noreferrer">https://storage.googleapis.com/chrome-for-testing-public</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.</p></td></tr><tr><td><spanid="executablepath">executablePath</span></td><td><p><code>optional</code></p></td><td><p>string</p></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><p><strong>Auto-computed.</strong></p></td></tr><tr><td><spanid="experiments">experiments</span></td><td><p><code>optional</code></p></td><td><p><ahref="/api/puppeteer.experimentsconfiguration">ExperimentsConfiguration</a></p></td><td><p>Defines experimental options for Puppeteer.</p></td><td></td></tr><tr><td><spanid="loglevel">logLevel</span></td><td><p><code>optional</code></p></td><td><p>'silent' | 'error' | 'warn'</p></td><td><p>Tells Puppeteer to log at the given level.</p></td><td><p><code>warn</code></p></td></tr><tr><td><spanid="skipchromedownload">skipChromeDownload</span></td><td><p><code>optional</code></p></td><td><p>boolean</p></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><spanid="skipchromeheadlessshelldownload">skipChromeHeadlessShellDownload</span></td><td><p><code>optional</code></p></td><td><p>boolean</p></td><td><p>Tells Puppeteer to not chrome-headless-shell download during installation.</p><p>Can be overridden by <code>PUPPETEER_SKIP_CHROME_HEADLESS_SHELL_DOWNLOAD</code>.</p></td><td></td></tr><tr><td><spanid="skipdownload">skipDownload</span></td><td><p><code>optional</code></p></td><td><p>boolean</p></td><td><p>Tells Puppeteer to not download during installation.</p><p>Can be overridden by <code>PUPPETEER_SKIP_DOWNLOAD</co
