# What changed in puppeteer

> 26 changes in puppeteer 24 to 25 from its official release notes, upgrade guides and advisories: 7 breaking, 2 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/puppeteer/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## puppeteer 25

### Breaking changes

- Puppeteer rolls to Chrome 155.0.8059.39, changing the Chrome version developers run with this release. (25.13.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.13.0)
- Puppeteer now rolls to Chrome 154.0.8037.57, changing the Chrome version used with Puppeteer. (25.12.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.12.0)
- defaultArgs now returns a Promise. (25.0.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.0.0)
- Packages are ESM-only, so projects must use ESM-compatible package loading. (25.0.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.0.0)
- executablePath now returns a Promise. (25.0.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.0.0)
- The minimum supported Node.js version is now 22. (25.0.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.0.0)
- The minimum TypeScript version is 5.0.1. (25.0.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.0.0)

### New APIs and options

- Adds support for the followSymlinks option. (25.8.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.8.0)

### Behavior and default changes

- Puppeteer rolls to Chrome 153.0.8010.36, changing the Chrome version it runs. (25.11.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.11.0)
- Puppeteer rolls to Chrome 152.0.7977.42, changing the Chrome version used with this release. (25.7.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.7.0)
- Puppeteer rolls to Chrome 151.0.7922.47, which may affect browser compatibility. (25.4.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.4.0)
- Puppeteer rolls to Chrome 149.0.7827.2, changing the Chrome version used by developers. (25.1.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.1.0)

### Fixes and other changes

- Users are told how to recover a partial browser folder. (25.8.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.8.0)
- Puppeteer rolls to Chrome 150.0.7871.24. (25.2.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.2.0)
- Reading configuration from `.puppeteerrc` is restored. (25.2.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.2.0)
- Removing the global skipDownload early return allows other configurations to be included. (25.2.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.2.0)
- Progress bar and installation behavior are improved. (25.1.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.1.0)
- Progress bars now support concurrency. (25.1.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v25.1.0)

## puppeteer 24

### New APIs and options

- WebDriver now supports fetchPostData. (24.26.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v24.26.0)

### Behavior and default changes

- Puppeteer rolls to Chrome 148.0.7778.56, changing the Chrome version used by developers. (24.43.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v24.43.0)
- Puppeteer now rolls to Chrome 147.0.7727.24, changing the Chrome version used when running Puppeteer. (24.41.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v24.41.0)
- Puppeteer rolls to Chrome 146.0.7680.31, changing the Chrome version used with this release. (24.38.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v24.38.0)
- Puppeteer rolls to Chrome 145.0.7632.26, changing the browser version developers run. (24.37.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v24.37.0)
- Puppeteer rolls to Chrome 144.0.7559.96, changing the browser version used with the release. (24.36.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v24.36.0)
- Puppeteer rolls to Chrome 143.0.7499.40, which may affect browser behavior when running Puppeteer. (24.32.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v24.32.0)
- Puppeteer rolls to a newer Chrome release, which may change browser behavior. (24.27.0) — [release notes](https://github.com/puppeteer/puppeteer/releases/tag/puppeteer-v24.27.0)