# puppeteer/puppeteer

JavaScript API for Chrome and Firefox

Repository: https://github.com/puppeteer/puppeteer
Canonical: https://ross.abutalabs.com/products/puppeteer
Homepage: https://pptr.dev
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: headless-chrome, testing, web, developer-tools, node-module, automation, chrome, chromium, firefox
Last push: 2026-08-26T19:21:43+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 3403, "days_push": 7, "days_rel": 8, "gap_med": 0.0, "n_releases_24m": 271}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 95497, forks 9567 (observed 2026-08-28T04:12:23.578009+00:00)

## What it is
Puppeteer is a JavaScript library providing a high-level API to control Chrome or Firefox over the DevTools Protocol or WebDriver BiDi, running headless by default. It is maintained by the Chrome Browser Automation team and supports browser automation, testing, scraping, and page rendering tasks.

## Use cases
- scrape dynamic web pages rendered with javascript
- run end-to-end browser tests for my web app
- take screenshots of web pages programmatically
- generate pdfs from html pages
- automate form filling and clicking in a browser
- test chrome extensions automatically

## When to choose
- you need a mature, actively maintained Node.js API for headless browser automation
- you want cross-browser automation of Chrome and Firefox including WebDriver BiDi support
- you need to scrape or test JavaScript-heavy sites that require a real browser

## When to avoid
- you need a lightweight HTTP client without a full browser
- you prefer Playwright's multi-language support or test runner integration
- your environment cannot download or run a Chromium/Firefox binary

## Facets
- artifact type: library
- maturity: stable
- function: http-client, testing, e2e-testing, web-scraping, developer-tools, workflow-automation
- domain: web-development, developer-tools, testing, crawlers
- platform: cross-platform, cli
- tags: headless-browser, chrome-devtools-protocol, webdriver-bidi, browser-automation, pdf-generation, screenshot, automation, nodejs

## Member repositories
- puppeteer/puppeteer (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:23.578009+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:12:38.176904+00:00, confidence not recorded.
  - readme: https://github.com/puppeteer/puppeteer (fetched 2026-08-28T04:12:23.578009+00:00, sha 7b422b09c98b)
  - homepage: https://pptr.dev (fetched 2026-08-28T17:35:04.622444+00:00, sha ba90981195aa)
  - site_page: https://pptr.dev/docs (fetched 2026-08-28T17:35:04.632902+00:00, sha 828eec1ddd49)
  - site_page: https://pptr.dev/category/introduction (fetched 2026-08-28T17:35:04.631109+00:00, sha fe8efc4f8190)
  - site_page: https://pptr.dev/faq (fetched 2026-08-28T17:35:04.634553+00:00, sha 57fd97bc1bf0)
- Data as of 2026-08-30T08:39:29.467469+00:00.