Skip to content

puppeteer

vbrowsers-v3.0.0 scope: browsers Breaking

This release includes 3 breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

automation chrome chromium developer-tools firefox headless-chrome
+3 more
node-module testing web

Affected surfaces

breaking_upgrade

ReleasePort's take

Moderate signal
editorial:auto 13d

All packages are now ESM‑only and the minimum supported Node.js version is 22.

Why it matters: Patch to Node.js ≥ 22 immediately; update any CJS‑based code paths before deploying browsers‑v3.0.0.

Summary

AI summary

Minimum Node.js version increased to 22, packages moved to ESM only, and public makeProgressCallback helper removed.

Changes in this release

Breaking Medium

All packages converted to ESM-only modules.

All packages converted to ESM-only modules.

Source: llm_adapter@2026-05-21

Confidence: high

Breaking Medium

Minimum Node.js v20.19 and TypeScript v5.0.1 required.

Minimum Node.js v20.19 and TypeScript v5.0.1 required.

Source: llm_adapter@2026-05-21

Confidence: high

Breaking Medium

Proxy agent made optional peer dependency, upgraded to v8.

Proxy agent made optional peer dependency, upgraded to v8.

Source: llm_adapter@2026-05-21

Confidence: high

Breaking Medium

Switched from extract-zip to OS native tar/unzip.

Switched from extract-zip to OS native tar/unzip.

Source: llm_adapter@2026-05-21

Confidence: high

Breaking Medium

Minimum Node.js version bumped to 22.

Minimum Node.js version bumped to 22.

Source: llm_adapter@2026-05-21

Confidence: low

Breaking Medium

Public makeProgressCallback helper function removed.

Public makeProgressCallback helper function removed.

Source: llm_adapter@2026-05-21

Confidence: low

Feature Medium

Experimental bisect CLI command added to browsers package.

Experimental bisect CLI command added to browsers package.

Source: llm_adapter@2026-05-21

Confidence: high

Performance Medium

Logger signature updated for improved performance.

Logger signature updated for improved performance.

Source: llm_adapter@2026-05-21

Confidence: high

Full changelog

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

🛠️ Fixes

📄 Documentation

⚡ Performance

🏗️ Refactor

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

Breaking Changes

  • Minimum Node.js version increased to 22 (also documented as requiring at least Node v20.19).
  • All packages moved to ESM only, dropping CommonJS support.
  • Public makeProgressCallback helper removed.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track puppeteer

Get notified when new releases ship.

Sign up free

About puppeteer

All releases →

Related context

Earlier breaking changes

Beta — feedback welcome: [email protected]