# addyosmani/puppeteer-webperf

Automating Web Performance testing with Puppeteer 🎪

Repository: https://github.com/addyosmani/puppeteer-webperf
Canonical: https://ross.abutalabs.com/products/puppeteer-webperf
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: web-performance, puppeteer, devtools, chrome, puppeteer-demo, chrome-devtools, lighthouse
Last push: 2023-01-18T10:55:29+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2320, "days_push": 1323, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1858, forks 91 (observed 2026-08-28T04:05:45.105181+00:00)

## What it is
A collection of JavaScript recipes for automating web performance measurement using Puppeteer and headless Chrome. It includes runnable examples for DevTools traces, Lighthouse reports, Core Web Vitals metrics, network throttling, and HAR capture.

## Use cases
- capture a devtools performance trace for a page load
- generate a lighthouse report programmatically
- measure largest contentful paint and cumulative layout shift
- emulate slow network and cpu throttling in tests
- save network requests to a har file
- measure memory leaks in a web app
- block third-party domains during performance testing

## When to choose
- you want copy-paste Puppeteer scripts for web performance measurement
- you are learning to automate Chrome DevTools Protocol performance tracing
- you need examples for collecting Core Web Vitals metrics

## When to avoid
- you need a maintained production performance-monitoring library
- you want a turnkey CI performance testing framework rather than example snippets
- you need non-Chromium browser support

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: testing, benchmarking, monitoring, developer-tools
- domain: web-development, performance, developer-tools, frontend
- platform: cli, cross-platform
- tags: puppeteer, web-performance, lighthouse, chrome-devtools, code-examples, headless-browser, core-web-vitals, nodejs

## Member repositories
- addyosmani/puppeteer-webperf (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:45.105181+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-30T03:16:02.110562+00:00, confidence not recorded.
  - readme: https://github.com/addyosmani/puppeteer-webperf (fetched 2026-08-28T04:05:45.105181+00:00, sha 1a8037c095e9)
- Data as of 2026-08-30T08:39:29.467469+00:00.