puppeteer/packages/browsers/CHANGELOG.md

Changelog

3.0.6 (2026-07-01)

📄 Documentation

• fix the typos on documentation (#15167) (ab74e6a)

🏗️ Refactor

• extract zip archives with yauzl instead of CLI tools (#15085) (04a9587)

3.0.5 (2026-06-22)

🛠️ Fixes

• browsers: add SHA-256 integrity verification for downloaded browser archives (#15093) (65a0a8d)
• browsers: validate channel in CLI launch for system browsers (#15098) (873b993)

3.0.4 (2026-05-26)

🛠️ Fixes

• improve progress bar and install (#15042) (51db32a)
• support concurrency in progress bars (#15045) (ab0171d)
• use powershell as fallback to unzip on Windows (#15033) (05f7b18)

🏗️ Refactor

• drop semver (#15029) (058cd5a)
• remove debug dependency (#15023) (94d1e1c)
• remove progress dependency (#15026) (e7d1a14)
• replace tar-fs with modern-tar (#15028) (054afed)

3.0.3 (2026-05-18)

🛠️ Fixes

• fix tar.exe invocation (#14997) (cce47de)

3.0.2 (2026-05-15)

🛠️ Fixes

• update docs text (#14992) (36527b8)

3.0.1 (2026-05-13)

🛠️ Fixes

• update browsers to trigger release (#14984) (bf05fb9)

3.0.0 (2026-05-12)

⚠ BREAKING CHANGES

• bump min NodeJS to 22 (#14973)
• update min version - Node v20.19 and Typescript v5.0.1 (#14364)
• move packages to ESM only (#14355)
• make proxy agent optional peer dependency and update to v8 (#14894)
• remove public makeProgressCallback helper (#13804)
• replace extract-zip with OS tar.exe or unzip (#14960)

🎉 Features

• browsers: add experimental bisect CLI command (#14746) (512d693)
• move packages to ESM only (#14355) (4c22177)

🛠️ Fixes

• remove public makeProgressCallback helper (#13804) (0876ee1)
• replace extract-zip with OS tar.exe or unzip (#14960) (55df174)

📄 Documentation

• bump min NodeJS to 22 (#14973) (4b6ddc3)
• update min version - Node v20.19 and Typescript v5.0.1 (#14364) (96f3780)

⚡ Performance

• browsers: update logger signature (#14968) (0f5a8d8)

🏗️ Refactor

• make proxy agent optional peer dependency and update to v8 (#14894) (501cccc)

2.13.2 (2026-05-11)

🛠️ Fixes

• do not use shell for setup.exe (#14959) (d8b5fd9)

2.13.1 (2026-05-06)

🛠️ Fixes

• Disable WebUIReloadButton experiment (#14925) (d9639e9)

2.13.0 (2026-02-18)

🎉 Features

• allow configuring the output of @puppeteer/browsers install (#14657) (1ce908e)

2.12.1 (2026-02-13)

🛠️ Fixes

• wsl: check for linux locations first (#14681) (11f01ef)

2.12.0 (2026-02-04)

🎉 Features

• core: support AbortSignal in launch (#14616) (d02459c)
• pluggable browser providers (#14552) (f4c9fee)

🛠️ Fixes

• do not write metadata when uninstalling (#14645) (1339379)

2.11.2 (2026-01-27)

🛠️ Fixes

• typo in the config path in getConfigHomeLinux (#14600) (c95d1bf)

2.11.1 (2026-01-12)

🛠️ Fixes

• firefox: set preference dismiss_file_pickers to true (#14540) (cc67588)

2.11.0 (2025-12-03)

🎉 Features

• add resolveDefaultUserDataDir for Chrome (#14463) (bc9aa6b)
• support channel in puppeteer.connect (#14466) (bc3a521)

🛠️ Fixes

• avoid hard-coded separators in chrome.ts (#14464) (372b280)

2.10.13 (2025-11-03)

📄 Documentation

• fix missing supported browser versions (#14383) (abf147a)

2.10.12 (2025-10-13)

Bug Fixes

• improve Chrome installation detection on Windows (#14304) (e37f856)

2.10.11 (2025-10-10)

Bug Fixes

• support multiple paths for system executables on Windows and WSL (#14286) (1ffcbb0)

2.10.10 (2025-09-15)

Bug Fixes

• always pipe stdio and report process launch errors (#14210) (c17a64b)
• check previously received log lines in waitForLineOutput (#14213) (8304bdd)
• disable browser.backup for Firefox (#14200) (6c751c4)

2.10.9 (2025-09-10)

Bug Fixes

• wait for file descriptors to close after download (#14183) (7645421)

2.10.8 (2025-08-28)

Bug Fixes

• move errors to Yargs parser (#14133) (db525f8)

2.10.7 (2025-08-20)

Bug Fixes

• browsers launch command should work with pinned browsers (#14110) (340e77e)

2.10.6 (2025-07-16)

Bug Fixes

• browsers: correctly handle LINUX_ARM in chromium data (#14032) (519d8e0)

2.10.5 (2025-05-20)

Bug Fixes

• don't expect extra arguments (#13886) (fd4e8d3)

2.10.4 (2025-05-07)

Bug Fixes

• decode URL before parsing (#13857) (c747eb8)

2.10.3 (2025-05-02)

Bug Fixes

• explicitly configure version in yargs (#13830) (6983da9)

2.10.2 (2025-04-22)

Bug Fixes

• revert makeProgressCallback changes (#13800) (f04ef25)
• support default download callback option in install() (#13801) (334e7ff)

2.10.1 (2025-04-22)

Bug Fixes

• dynamically import yargs and progress in CLI (#13781) (3cfed9b)

2.10.0 (2025-04-09)

Features

• expose utilities for managing browser artifacts manually (#13761) (43baf13)

2.9.0 (2025-03-31)

Features

• support dumpio option on launch (#13656) (332af85)
• support extra args to launch (#13658) (844f013)

2.8.0 (2025-03-05)

Features

• add firefox arm64 downloads (#13646) (92ca975)

2.7.1 (2025-02-05)

Bug Fixes

• close the readline interface (#13558) (7073519)

2.7.0 (2025-01-09)

Features

• resolve relative paths to absolute before unpacking (#13466) (f23c391)

Bug Fixes

• skip retries for same URL (#13469) (04135ec)

2.6.1 (2024-12-10)

Bug Fixes

• support .tar.xz archives for Firefox 135+ (#13391) (d247a7f)

2.6.0 (2024-12-09)

Features

• allow listing installed browsers (#13385) (8b814bf)

2.5.0 (2024-12-03)

Features

• support LaunchOptions in executablePath() (#13340) (6acfee6)

2.4.1 (2024-11-04)

Bug Fixes

• browsers: correctly import yargs for esm module (#13249) (694fef9)

2.4.0 (2024-09-04)

Features

• support --install-deps flag in the browsers CLI (#12580) (b832417)

2.3.1 (2024-08-14)

Bug Fixes

• firefox: back up user.js as well (#12943) (9feda9c)

2.3.0 (2024-07-25)

Features

• allow downloading of all pinned browsers (#12806) (e72e7ab)

Bug Fixes

• configure sandbox permissions for Chrome on Windows (#12430) (b1bf89d)

2.2.4 (2024-07-17)

Bug Fixes

• use spawn instead of exec in fileUtil (#12758) (9ce6a85)

2.2.3 (2024-04-25)

Bug Fixes

• performance: speed up Firefox profile creation (#12320) (c9a5644)

2.2.2 (2024-04-15)

Bug Fixes

• remove NetworkServiceInProcess2 set by default (#12261) (ff4f70f), closes #12257

2.2.1 (2024-04-05)

Bug Fixes

• do not use fallback download URLs if custom baseUrl is provided (#12206) (ab560bc)
• only set up a single process event listener in launch (#12200) (7bc5e0f)

2.2.0 (2024-03-15)

Features

• allow downloading Firefox channels other than nightly (#12051) (e4cc2f9)

Bug Fixes

• don't keep connection alive (#12096) (0a142bf)

2.1.0 (2024-02-21)

Features

• allow comparing browser versions (#11954) (bf71b34)
• support local aliases when launching a browser (#11947) (561e4cd)

Bug Fixes

• check if executable exists (#11946) (e95a308)
• implement a fallback to download URLs provided by dashboard (#11951) (73c1f9b)

2.0.1 (2024-02-17)

Bug Fixes

• Chrome for Testing downloads have a new URL (#11923) (f00a94a)

2.0.0 (2024-02-05)

⚠ BREAKING CHANGES

• drop support for node16 (#10912)

Features

• drop support for node16 (#10912) (953f420)

1.9.1 (2024-01-04)

Bug Fixes

• disable GFX sanity window for Firefox and enable WebDriver BiDi CI jobs for Windows (#11578) (e41a265)

1.9.0 (2023-12-05)

Features

• implement the Puppeteer CLI (#11344) (53fb69b)

Bug Fixes

• ng-schematics install Windows (#11487) (02af748)
• remove CDP-specific preferences from defaults for Firefox (#11477) (f8c9469)

1.8.0 (2023-10-20)

Features

• enable tab targets (#11099) (8324c16)

1.7.1 (2023-09-13)

Bug Fixes

• use supported node range for types (#10896) (2d851c1)

1.7.0 (2023-08-18)

Features

• support chrome-headless-shell (#10739) (416843b)

1.6.0 (2023-08-10)

Features

• allow installing chrome/chromedriver by milestone and version prefix (#10720) (bec2357)

1.5.1 (2023-08-08)

Bug Fixes

• add buildId to archive path (#10699) (21461b0)

1.5.0 (2023-08-02)

Features

• add executablePath to InstalledBrowser (#10594) (87522e7)

Bug Fixes

• clear pending TLS socket handle (#10667) (87bd791)
• remove typescript from peer dependencies (#10593) (c60572a)

1.4.6 (2023-07-20)

Bug Fixes

• restore proxy-agent (#10569) (bf6304e)

1.4.5 (2023-07-13)

Bug Fixes

• stop relying on vm2 (via proxy agent) (#10548) (4070cd6)

1.4.4 (2023-07-11)

Bug Fixes

• correctly parse the default buildId (#10535) (c308266)
• remove Chromium channels (#10536) (c0dc8ad)

1.4.3 (2023-06-29)

Bug Fixes

• negative timeout doesn't break launch (#10480) (6a89a2a)

1.4.2 (2023-06-20)

Bug Fixes

• include src into published package (#10415) (d1ffad0)

1.4.1 (2023-05-31)

Bug Fixes

• pass on the auth from the download URL (#10271) (3a1f4f0)

1.4.0 (2023-05-24)

Features

• use proxy-agent to support various proxies (#10227) (2c0bd54)

1.3.0 (2023-05-15)

Features

• add ability to uninstall a browser (#10179) (d388a6e)

Bug Fixes

• update the command name (#10178) (ccbb82d)

1.2.0 (2023-05-11)

Features

• support Chrome channels for ChromeDriver (#10158) (e313b05)

1.1.0 (2023-05-08)

Features

• support stable/dev/beta/canary keywords for chrome and chromium (#10140) (90ed263)

1.0.1 (2023-05-05)

Bug Fixes

• rename PUPPETEER_DOWNLOAD_HOST to PUPPETEER_DOWNLOAD_BASE_URL (#10130) (9758cae)

1.0.0 (2023-05-02)

⚠ BREAKING CHANGES

• drop support for node14 (#10019)
• switch to Chrome for Testing instead of Chromium (#10054)

Features

• drop support for node14 (#10019) (7405d65)
• switch to Chrome for Testing instead of Chromium (#10054) (df4d60c)

Bug Fixes

• add Host header when used with http_proxy (#10080) (edbfff7)

0.5.0 (2023-04-21)

Features

• browser: add a method to get installed browsers (#10057) (e16e2a9)

0.4.1 (2023-04-13)

Bug Fixes

• report install errors properly (#10016) (7381229)

0.4.0 (2023-04-06)

Features

• browsers: support downloading chromedriver (#9990) (ef0fb5d)

0.3.3 (2023-04-06)

Bug Fixes

• browsers: update package json (#9968) (817288c)
• browsers: various fixes and improvements (#9966) (f1211cb)
• consider downloadHost as baseUrl (#9973) (05a44af)

0.3.2 (2023-04-03)

Bug Fixes

• typo in the browsers package (#9957) (c780384)

0.3.1 (2023-03-29)

Bug Fixes

• bump @puppeteer/browsers (#9938) (2a29d30)

0.3.0 (2023-03-27)

Features

• update Chrome browser binaries (#9917) (fcb233c)

0.2.0 (2023-03-24)

Features

• implement a command to clear the cache (#9868) (b8d38cb)

0.1.1 (2023-03-14)

Bug Fixes

• export ChromeReleaseChannel (#9851) (3e7a514)

0.1.0 (2023-03-14)

Features

• implement system channels for chrome in browsers (#9844) (dec48a9)

Bug Fixes

• add browsers entry point (#9846) (1a1e79d)

0.0.5 (2023-03-07)

Bug Fixes

• change the install output to include the executable path (#9797) (8cca7bb)

0.0.4 (2023-03-06)

Features

• browsers: recognize chromium as a valid browser (#9760) (04247a4)

0.0.3 (2023-02-22)

Bug Fixes

• define options per command (#9733) (8bae054)

0.0.2 (2023-02-22)

Bug Fixes

• permissions for the browser CLI (#9731) (e944931)

0.0.1 (2023-02-22)

Features

• initial release of browsers (#9722) (#9727) (86a2d1d)