mrkeyoor.com_
Fri 11 Sept 06:45 UTC
Webevaluationupdated 11 Sept 2026

lighthouse review

Lighthouse runs a controlled Chrome session against a web page and reports problems in performance, accessibility, SEO, and browser best practices. It gives web teams a repeatable lab inspection through Chrome DevTools, a command-line tool, or a Node module, with HTML, JSON, and CSV output for humans and automation.

Verdict

Our Lighthouse checkout installed 1,036 packages in 95 seconds and occupied 586 MB, then its tests failed after 4 seconds when Node could not open dist/report/flow.js. Use the packaged CLI or Chrome DevTools for quick, local evidence across four audit categories, and use Lighthouse CI or another runner when scores will block a release. It is a mature audit engine, but one synthetic score is too variable to stand in for repeated lab runs or real-user data.

We ran it

Lab card: what happened when we ran lighthouseScreenshot of lighthouse (developer.chrome.com/docs/lighthouse/overview)
Install✓ · 95s1036 packages · 586 MB
Buildn/ano build script
Tests✗ · 4sran, no count parsed
Repo1518 files~149,990 lines of source · 219.3 MB · 7 CI workflows

Answers from our run

Does lighthouse build from source?

Dependencies installed in 95 seconds (1036 packages), and the project has no separate build step. We cloned commit 7d21d0b into a clean Debian container with 3 CPUs and no project-specific setup.

Do lighthouse's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use lighthouse?

Teams that need real-user performance data: the README describes Lighthouse as a local lab run, and its variability guide warns that page, network, hardware, and browser conditions move results.

What are the alternatives to lighthouse?

Lighthouse CI, sitespeed.io, web-vitals. Our Lighthouse checkout installed 1,036 packages in 95 seconds and occupied 586 MB, then its tests failed after 4 seconds when Node could not open `dist/report/flow.

Setup3/5DevTools is easy; source install was 586 MB and tests failed
Docs5/5CLI, Node, auth, configuration, and variance are explained
Community5/530,758 stars with code merged on 2026-09-10
Maturity4/5v13.4.1 is widely integrated; our fresh test run still failed

Who it’s for

Front-end developers who want a fast audit while building or debugging one page.
CI owners who can run several controlled samples and treat scores as regression signals.
Accessibility, SEO, and performance specialists who need trace data and audit details in one report.
Tool builders who want JSON output, a Node API, plugins, custom audits, or saved gather artifacts.

Who it’s NOT for

Teams that need real-user performance data: the README describes Lighthouse as a local lab run, and its variability guide warns that page, network, hardware, and browser conditions move results.
Anyone planning to fail a deployment from one score: the project tells users to run Lighthouse multiple times in a consistent environment and aggregate the results.
Operators without Chrome or Node 22 or later: both are documented requirements for the local CLI path.
Contributors expecting a light fresh-clone check: our install added 1,036 packages and used 586 MB, then the test command failed while opening a missing report file.

Setup reality

Our sandbox install at commit 7d21d0b succeeded in 95 seconds, adding 1,036 packages and using 586 MB. The harness found no supported build script or target, so build was skipped. Tests failed with exit code 1 after 4 seconds because Node could not open dist/report/flow.js.

Local audits need Node 22 or later and an installed Chrome or Chromium binary; they need no hosted account. Logged-in pages require a prepared browser session, Puppeteer, or explicit request headers. Sharing through the online viewer signs in to GitHub and stores the report as a secret Gist.

The 219.3 MB checkout contained 1,518 files and about 149,990 source lines, with 7 CI workflows but no Dockerfile or tests directory. Performance results vary with the page, server, network, browser, and client load, so production gates need controlled repeated runs.

Four audit categories cover the page, not the whole product

The CLI exposes 4 main categories: performance, accessibility, best practices, and SEO. A run launches Chrome, gathers page artifacts, applies audits, and writes an HTML report by default. JSON and CSV outputs make the same findings usable in scripts. Chrome DevTools is the easiest route for a developer inspecting the current tab, while the CLI adds flags for throttling, device emulation, selected audits, extra headers, saved traces, and output paths.

That friendly report sits on a large codebase. Our checkout contained 1,518 files, about 149,990 lines of source, and 219.3 MB before installation. The repository includes the core runner, report renderer, browser clients, localization, fixtures, and build tooling. A team embedding Lighthouse through its Node module should pin the package and the Chrome environment rather than treating the score as a simple HTTP API whose behavior stays fixed independently of its browser.

Node 22 and local Chrome are required for the CLI

The README requires Node 22 or later and a local Chrome installation. A basic command takes one URL and writes a dated report, while CHROME_PATH selects a specific browser binary. Mobile emulation and network or CPU throttling are enabled through configuration. The run happens locally, and the FAQ says reports are not processed by a remote server. That makes the CLI suitable for private preproduction pages when the test machine can reach them.

Authenticated pages need deliberate session handling. Lighthouse normally loads a page as a new user, with no prior storage. The docs describe 4 working paths: script login with Puppeteer, use the logged-in DevTools tab, pass headers, or connect to a prepared debugging browser. Sharing is a separate privacy choice. The online viewer can open a local JSON report, while its share action requires GitHub sign-in and saves the report as a secret Gist.

What happened when we ran it

Our sandbox installed 1,036 Yarn packages in 95 seconds and consumed 586 MB on disk. The harness found no supported build script or target, so it skipped build rather than marking it successful or failed. The repository README gives contributors a separate build-all command, but our measured result covers only what the harness invoked. This was commit 7d21d0b in an unprivileged container with 3 CPUs, 8 GB of RAM, and no secrets.

The test command failed with exit code 1 after 4 seconds. Its final useful error says Node tried to open dist/report/flow.js and could not. The log tail does not establish why that file was absent, so we cannot say whether a particular build command, package state, or repository defect caused it. Our scan found 7 CI workflow files, no Dockerfile, and no tests directory. The fresh checkout simply did not pass the test step we ran.

Repeated controlled runs matter more than one green score

Lighthouse's own variability guide lists changing page behavior, network conditions, server response, client hardware, resource contention, and browser scheduling as sources of movement. It recommends consistent hardware, isolated runs, and aggregate values from multiple attempts. A single performance score can be useful for finding a severe regression, but it is weak evidence for a small improvement. Accessibility and SEO audits also catch detectable rules, not every usability or search problem.

Our 3-CPU, 8 GB sandbox result measured repository setup and tests; it did not audit a target website or produce a performance score. That boundary prevents a common category error. Before making Lighthouse a release condition, run the actual production-like page several times on stable hardware, preserve the JSON, and compare distributions. Pair those lab results with field data if real users matter. The web-vitals library is a narrower option for measurements collected during actual visits.

The CLI is strongest as an engine inside a repeatable process

Saved gather artifacts let teams collect browser data once and audit it later, which helps separate collection from report generation. Custom configurations can select audits or add new gatherers, and plugins can package specialized checks. Output in 3 formats also makes it straightforward to archive a human report while parsing JSON for a dashboard. These are strong building blocks, though Lighthouse itself does not supply a full history, alert policy, or multi-page crawler.

Lighthouse CI is the natural companion when every commit needs several samples and budget assertions. sitespeed.io is a better fit for broader site runs and long-term performance records. The raw Lighthouse CLI remains useful for a developer who wants one trace-rich inspection without operating a monitoring service. Its 586 MB installed footprint and browser requirement are acceptable on a dedicated CI worker, but costly in a small utility container used for many unrelated checks.

v13.4.1 is active despite 469 open items

GitHub recorded a September 10, 2026 push, 30,758 stars, 428 open issues, and 41 open pull requests. Release v13.4.1 was published on July 20 after four earlier v13 releases between April and June. The latest repository activity included merged test and browser-integration work. That combination shows current maintenance and a large support surface; the 469 combined items should not be read as 469 confirmed bugs.

Lighthouse earns its place in a web team's diagnostic kit because the browser integration, audit explanations, saved artifacts, and machine-readable output are useful together. The source checkout was less tidy in our run: 1,036 packages installed cleanly, then tests stopped on a missing report file. Most users should consume the released tool, repeat important runs, and keep real-user evidence beside the lab report before a score blocks deployment.

Alternatives

ProjectWhat it isPick it when
Lighthouse CIGoogle's companion tooling for repeated Lighthouse runs and regression checks in CI.pick this instead when the main job is collecting several runs per commit and enforcing budgets.
sitespeed.ioA browser performance toolkit built for repeated tests, multiple pages, budgets, and stored results.pick this instead when you need site-level performance monitoring and historical comparisons rather than one report.
web-vitalsA small browser library for collecting Web Vitals from actual page visits.pick this instead when field measurements from real users matter more than a synthetic Chrome audit.

What people are saying

  1. [velocity-scout] GoogleChrome/lighthouse

Sources

  1. Lighthouse repository
  2. Lighthouse README
  3. Lighthouse variability guide
  4. Lighthouse authenticated-pages guide
  5. Lighthouse v13.4.1 release
  6. Lighthouse issues and pull requests

More web reviews

video.js · fluentui · return-youtube-dislike · remix · bootstrap · analytics · the whole board →