puppeteer
Use when working with Puppeteer for browser automation, Chrome DevTools Protocol, headless Chrome, web scraping, PDF generation, or screenshot automation. Also use when working with Chrome for Testing, debugging CDP connections, or WebDriver BiDi.
| Model | Source | Category |
|---|---|---|
| sonnet | core | Testing |
Overview
Section titled “Overview”Puppeteer is Google’s Node.js library for controlling Chrome/Firefox via the DevTools Protocol (CDP) or WebDriver BiDi. Current version: 24.37.4 (February 2026), bundling Chrome for Testing.
Full Reference
Puppeteer
Section titled “Puppeteer”Overview
Section titled “Overview”Puppeteer is Google’s Node.js library for controlling Chrome/Firefox via the DevTools Protocol (CDP) or WebDriver BiDi. Current version: 24.37.4 (February 2026), bundling Chrome for Testing.
Quick Reference
Section titled “Quick Reference”| Item | Value |
|---|---|
| Current Version | 24.37.4 (February 2026) |
| Install | npm install puppeteer |
| Install (no browser) | npm install puppeteer-core |
| Config | .puppeteerrc.cjs or puppeteer.config.ts |
| Bundled Browser | Chrome for Testing (auto-downloaded) |
| Node.js | 18+ required |
| Protocols | CDP (Chrome default), WebDriver BiDi (Firefox default) |
Reference Index
Section titled “Reference Index”Load the specific file for the task at hand:
| Task | File |
|---|---|
| Install, config, env vars | reference/installation.md |
| Launch browser, pages, connect | reference/browser-and-pages.md |
| CSS/XPath/ARIA selectors, Locator API, forms | reference/selectors-and-interaction.md |
| goto, waitUntil, waitForSelector, waitForFunction | reference/navigation-and-waiting.md |
| Intercept requests, mock responses, monitor network | reference/network-interception.md |
| Screenshots, PDF generation | reference/screenshots-and-pdfs.md |
| page.evaluate, page.$eval, exposeFunction | reference/javascript-evaluation.md |
| File input upload, download to disk | reference/file-uploads-and-downloads.md |
| CDP sessions, raw protocol, network emulation | reference/cdp-sessions.md |
| headless: true vs ‘shell’ vs false, version history | reference/headless-modes.md |
| Isolated sessions, incognito, permissions | reference/browser-contexts.md |
| Promise.all pages, worker pools, multiple browsers | reference/parallel-execution.md |
| Docker Dockerfile, GitHub Actions, GitLab CI | reference/cicd-and-docker.md |
| slowMo, DEBUG env, console events, error table | reference/debugging.md |
| Chrome for Testing, Firefox, WebDriver BiDi, stealth | reference/chrome-for-testing-and-firefox.md |