npm / puppeteer
puppeteer
What changed in puppeteer 24 to 25, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.
7 breaking2 new APIs and options11 behavior and defaults6 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initpuppeteer 2518 changes
Breaking changes 7
Puppeteer rolls to Chrome 155.0.8059.39, changing the Chrome version developers run with this release.
Puppeteer now rolls to Chrome 154.0.8037.57, changing the Chrome version used with Puppeteer.
defaultArgs now returns a Promise.
Packages are ESM-only, so projects must use ESM-compatible package loading.
executablePath now returns a Promise.
The minimum supported Node.js version is now 22.
The minimum TypeScript version is 5.0.1.
New APIs and options 1
Adds support for the followSymlinks option.
Behavior and default changes 4
Puppeteer rolls to Chrome 153.0.8010.36, changing the Chrome version it runs.
Puppeteer rolls to Chrome 152.0.7977.42, changing the Chrome version used with this release.
Puppeteer rolls to Chrome 151.0.7922.47, which may affect browser compatibility.
Puppeteer rolls to Chrome 149.0.7827.2, changing the Chrome version used by developers.
Fixes and other changes 6
Users are told how to recover a partial browser folder.
Puppeteer rolls to Chrome 150.0.7871.24.
Reading configuration from
.puppeteerrcis restored.Removing the global skipDownload early return allows other configurations to be included.
Progress bar and installation behavior are improved.
Progress bars now support concurrency.
puppeteer 248 changes
New APIs and options 1
WebDriver now supports fetchPostData.
Behavior and default changes 7
Puppeteer rolls to Chrome 148.0.7778.56, changing the Chrome version used by developers.
Puppeteer now rolls to Chrome 147.0.7727.24, changing the Chrome version used when running Puppeteer.
Puppeteer rolls to Chrome 146.0.7680.31, changing the Chrome version used with this release.
Puppeteer rolls to Chrome 145.0.7632.26, changing the browser version developers run.
Puppeteer rolls to Chrome 144.0.7559.96, changing the browser version used with the release.
Puppeteer rolls to Chrome 143.0.7499.40, which may affect browser behavior when running Puppeteer.
Puppeteer rolls to a newer Chrome release, which may change browser behavior.