Do these 3 things before closing this tab:
1Fix the driver behind crashes, sound loss and screen glitches2Clear out junk files and repair common Windows errors3Scan for outdated or missing drivers - takes under a minuteFor most users, the easiest way to use Puppeteer’s browser-management CLI is to run npx @puppeteer/browsers --help and then use its shell commands. Instantiate the exported CLI class directly only when embedding or customizing the CLI in JavaScript or TypeScript. The examples below explain both paths and distinguish the public CLI constructor from InstalledBrowser, whose constructor Puppeteer marks as internal.
Use the CLI from a shell
Start with the package’s help output, then ask for help on a specific command to see options available in the version you are running:
npx @puppeteer/browsers --help
npx @puppeteer/browsers install --help
npx @puppeteer/browsers launch --help
npx @puppeteer/browsers list --help
npx @puppeteer/browsers clear --helpIf the package is installed in the current project, npx runs that installed copy; otherwise, it installs and runs the package. To use a particular package release, pin it in the command, for example npx @puppeteer/browsers@2.4.1 --help. You can also request the latest release explicitly, but a pinned version makes the invoked package release clear.
Install, list, and clear browser downloads
Puppeteer documents these example commands:
npx @puppeteer/browsers install chrome@stable
npx @puppeteer/browsers install chrome@117
npx @puppeteer/browsers install chromedriver@canary
npx @puppeteer/browsers list
npx @puppeteer/browsers clearBrowser identifiers and build IDs are browser-specific. You can select a release channel or specify a version, milestone, or other build ID supported for that browser. Treat examples such as chrome@117 as illustrations, not guarantees that the same build will remain available. Check current command help and select a build intentionally. See the Puppeteer browsers documentation.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
Install Chrome dependencies on Ubuntu or Debian
For Chrome on Ubuntu or Debian, Puppeteer documents this command to install Chrome and its required system dependencies:
npx puppeteer browsers install chrome --install-depsThis option is documented for Chrome on Ubuntu/Debian, not as a general cross-platform dependency installer, and it requires root privileges. Use it only in the supported environment.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
Instantiate the public CLI class
The public constructor accepts either a cache-path string or an options object as its first argument, plus an optional readline.Interface as the second argument. The object form is useful when embedding the CLI and setting its defaults:
import {CLI} from '@puppeteer/browsers';
const cli = new CLI({
cachePath: '/tmp/browser-cache',
scriptName: 'my-browser-tool',
});The string shorthand sets the cache path:
import {CLI} from '@puppeteer/browsers';
const cli = new CLI('/tmp/browser-cache');These snippets illustrate the documented constructor signature; they are not a claim that a particular release was runtime-tested. Use the exported API and the types in the exact installed release, since the implementation on the rolling source branch can change.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
Constructor arguments and defaults
| Argument or option | Type | Behavior |
|---|---|---|
| First argument as a string | string |
Shorthand for the cache path. |
cachePath |
string |
Browser cache path. Defaults to process.cwd() when omitted. |
scriptName |
string |
CLI name used in its presentation; defaults to @puppeteer/browsers. |
version |
string |
CLI version; defaults to the package’s compiled version value. |
prefixCommand |
{cmd: string; description: string} |
Optional command prefix and its description for customizing command presentation. |
allowCachePathOverride |
boolean |
Whether the cache path can be overridden; defaults to true. |
pinnedBrowsers |
Partial<Record<Browser, {buildId: string; skipDownload: boolean}>> |
Optional browser build IDs and skip-download flags for the CLI’s pinned-browser workflow. |
Second argument or rl option |
readline.Interface |
Optional readline interface. |
When to use a cache path or pinned browser
Choose the cache path based on where the downloaded browsers should live: the constructor defaults to the current working directory, while Puppeteer’s documented browser-download configuration uses ~/.cache/puppeteer starting with v19.0.0. The standalone constructor’s default and Puppeteer’s configured download location are different contexts; don’t assume changing one changes the other.
The pinnedBrowsers option is for defining browser builds and skip-download behavior in a CLI workflow. For ordinary browser selection, the shell command’s browser-specific channel or build ID is often simpler. A channel such as stable tracks a release channel; a specific build ID expresses a fixed selection, subject to availability. Consult the relevant command help and package types for the installed release.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Choose the standalone CLI or Puppeteer’s wrapper
npx @puppeteer/browsers runs the standalone browser-management package. Puppeteer also documents a puppeteer browsers wrapper for browser installation tasks, such as the Ubuntu/Debian Chrome dependency command above. Which command applies depends on whether you are using the standalone package or a Puppeteer installation and on the specific browser and platform; the commands are not interchangeable in every environment.
For browser downloads managed through Puppeteer, the configuration guide supports configuration files and applicable environment variables, with environment variables taking precedence. Proxy settings are environment-only: HTTP_PROXY, HTTPS_PROXY, and NO_PROXY. Proxy downloads require the optional proxy-agent peer dependency. Puppeteer configuration files and environment variables are ignored by puppeteer-core. If you change browser download options in configuration, rerun the install step:
Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Repair Windows errors before they cause bigger problemsFix Now →Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
npx puppeteer browsers installSee Puppeteer’s configuration guide for supported configuration file locations and formats.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Keep the browser compatible with Puppeteer
Browser compatibility depends on the Puppeteer release. Puppeteer’s support guidance says v20.0.0 and later use Chrome for Testing, while v23.0.0 and later download and work with stable Firefox. Use the version mapping table on the supported browsers page for the release you have; if an exact Puppeteer version is absent, the page says to use the supported browser version for the immediately prior Puppeteer version listed. The mapping can change, so don’t treat a version example from an older guide as a current compatibility guarantee.
Do not construct InstalledBrowser directly
CLI is the class to consider when your code needs to embed or customize the command-line interface. InstalledBrowser represents an installed browser, but its API documentation marks the constructor internal and says: “Third-party code should not call the constructor directly or create subclasses that extend the InstalledBrowser class.” Use supported exported APIs instead of instantiating that class yourself. See the browsers API documentation.
Common setup problems
- The command uses an unexpected package version:
npxuses the project’s installed copy when present. Check the installed dependency and pin the version in the invocation when you need a specific release. - A browser build cannot be installed: build identifiers are browser-specific and availability can change. Confirm the identifier and current options with
install --help, and choose a supported channel or build ID. - System dependency installation fails:
--install-depsis documented for Chrome on Ubuntu/Debian and requires root privileges. Verify the operating system, browser, and privileges rather than treating the flag as a general installer. - A configured download path or proxy has no effect: ensure you are using Puppeteer rather than
puppeteer-coreif relying on Puppeteer configuration. Proxy variables are environment-only, and proxy downloads need the optionalproxy-agentpeer dependency. Rerunnpx puppeteer browsers installafter changing download configuration. - The installed browser does not match expectations: check the supported-browser mapping for the Puppeteer version in use, especially when choosing a specific browser build rather than a channel.
- Constructor code stops compiling after an upgrade: check the types exported by the exact installed
@puppeteer/browsersrelease; the source on the main branch is not a substitute for that release’s API.
Or skip the browser setup
If your goal is to capture a website rather than manage a local browser, ScreenshotNeo provides a screenshot API and MCP server. A single GET request returns a PNG, JPEG, WebP, or PDF; see the API documentation.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteWindows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallcurl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpScreenshotNeo removes cookie and consent banners, newsletter popups, and chat widgets before capture; those cleanup steps can be turned off. Bot checks/CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and responses identify the page verdict and billing status in headers. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for AI agents. The free plan includes 1,000 screenshots per month without a card; paid plans start at $5 for 3,000 shots.
Sign up for ScreenshotNeo free: 1,000 screenshots a month, no card required.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
