<titledata-rh="true">@puppeteer/browsers | 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/browsers-api/"><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="@puppeteer/browsers | Puppeteer"><metadata-rh="true"name="description"content="Manage and launch browsers/drivers from a CLI or programmatically."><metadata-rh="true"property="og:description"content="Manage and launch browsers/drivers from a CLI or programmatically."><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://pptr.dev/browsers-api/"><linkdata-rh="true"rel="alternate"href="https://pptr.dev/browsers-api/"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://pptr.dev/browsers-api/"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>Manage and launch browsers/drivers from a CLI or programmatically.</p>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="cli">CLI<ahref="#cli"class="hash-link"aria-label="Direct link to CLI"title="Direct link to CLI"></a></h2>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="known-limitations">Known limitations<ahref="#known-limitations"class="hash-link"aria-label="Direct link to Known limitations"title="Direct link to Known limitations"></a></h2>
<ol>
<li>Launching the system browsers is only possible for Chrome/Chromium.</li>
</ol>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="api">API<ahref="#api"class="hash-link"aria-label="Direct link to API"title="Direct link to API"></a></h2>
<p>The programmatic API allows installing and launching browsers from your code. See the <code>test</code> folder for examples on how to use the <code>install</code>, <code>canInstall</code>, <code>launch</code>, <code>computeExecutablePath</code>, <code>computeSystemExecutablePath</code> and other methods.</p>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="classes">Classes<ahref="#classes"class="hash-link"aria-label="Direct link to Classes"title="Direct link to Classes"></a></h2>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="enumerations">Enumerations<ahref="#enumerations"class="hash-link"aria-label="Direct link to Enumerations"title="Direct link to Enumerations"></a></h2>
<table><thead><tr><th><p>Enumeration</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><spanid="browser"><ahref="/browsers-api/browsers.browser">Browser</a></span></td><td><p>Supported browsers.</p></td></tr><tr><td><spanid="browserplatform"><ahref="/browsers-api/browsers.browserplatform">BrowserPlatform</a></span></td><td><p>Platform names used to identify a OS platform x architecture combination in the way that is relevant for the browser download.</p></td></tr><tr><td><spanid="chromereleasechannel"><ahref="/browsers-api/browsers.chromereleasechannel">ChromeReleaseChannel</a></span></td><td></td></tr></tbody></table>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="functions">Functions<ahref="#functions"class="hash-link"aria-label="Direct link to Functions"title="Direct link to Functions"></a></h2>
<table><thead><tr><th><p>Function</p></th><th><p>Description</p></th></tr></thead><tbody><tr><td><spanid="candownload"><ahref="/browsers-api/browsers.candownload">canDownload(options)</a></span></td><td></td></tr><tr><td><spanid="computeexecutablepath"><ahref="/browsers-api/browsers.computeexecutablepath">computeExecutablePath(options)</a></span></td><td></td></tr><tr><td><spanid="computesystemexecutablepath"><ahref="/browsers-api/browsers.computesystemexecutablepath">computeSystemExecutablePath(options)</a></span></td><td></td></tr><tr><td><spanid="createprofile"><ahref="/browsers-api/browsers.createprofile">createProfile(browser, opts)</a></span></td><td></td></tr><tr><td><spanid="detectbrowserplatform"><ahref="/browsers-api/browsers.detectbrowserplatform">detectBrowserPlatform()</a></span></td><td></td></tr><tr><td><spanid="getinstalledbrowsers"><ahref="/browsers-api/browsers.getinstalledbrowsers">getInstalledBrowsers(options)</a></span></td><td><p>Returns metadata about browsers installed in the cache directory.</p></td></tr><tr><td><spanid="getversioncomparator"><ahref="/browsers-api/browsers.getversioncomparator">getVersionComparator(browser)</a></span></td><td><p>Returns a version comparator for the given browser that can be used to sort browser versions.</p></td></tr><tr><td><spanid="install"><ahref="/browsers-api/browsers.install">install(options)</a></span></td><td></td></tr><tr><td><spanid="install"><ahref="/browsers-api/browsers.install_1">install(options)</a></span></td><td></td></tr><tr><td><spanid="launch"><ahref="/browsers-api/browsers.launch">launch(opts)</a></span></td><td></td></tr><tr><td><spanid="makeprogresscallback"><ahref="/browsers-api/browsers.makeprogresscallback">makeProgressCallback(browser, buildId)</a></span></td><td></td></tr><tr><td><spanid="resolvebuildid"><ahref="/browsers-api/browsers.resolvebuildid">resolveBuildId(browser, platform, tag)</a></span></td><td></td></tr><tr><td><spanid="uninstall"><ahref="/browsers-api/browsers.uninstall">uninstall(options)</a></span></td><td></td></tr></tbody></table>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="interfaces">Interfaces<ahref="#interfaces"class="hash-link"aria-label="Direct link to Interfaces"title="Direct link to Interfaces"></a></h2>
<h2class="anchor anchorWithStickyNavbar_LWe7"id="variables">Variables<ahref="#variables"class="hash-link"aria-label="Direct link to Variables"title="Direct link to Variables"></a></h2>