puppeteer-extra SOP

Appearance

Install ​

Core package ​

Install puppeteer-extra alongside the standard Puppeteer package:

bash
npm install puppeteer puppeteer-extra

Or with yarn:

bash
yarn add puppeteer puppeteer-extra

Stealth plugin (most common addition) ​

bash
npm install puppeteer-extra-plugin-stealth

Adblocker plugin ​

bash
npm install puppeteer-extra-plugin-adblocker

reCAPTCHA solver plugin ​

bash
npm install puppeteer-extra-plugin-recaptcha

TypeScript types ​

Types are bundled in the packages themselves. No separate @types/ install is needed.

Peer dependency note ​

puppeteer-extra wraps the official puppeteer package; it does not bundle Chromium itself. The puppeteer package automatically downloads a pinned Chromium build on npm install. If you are in a constrained environment (Docker, CI, serverless), you can pass --ignore-scripts and point executablePath to your own Chromium binary at launch time.

Playwright variant ​

If you are using Playwright instead of Puppeteer, the same plugin ecosystem is available via playwright-extra:

bash
npm install playwright playwright-extra