Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including lighthouse-batch with all npm packages installed. Try it out:

var lighthouseBatch = require("lighthouse-batch")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

lighthouse-batch v5.0.2

Generate lighthouse reports for one or more websites

Lighthouse Batch Reporter

Supports executing Lighthouse analysis over a number of sites in sequence and generating a summary report including all of their scores. Scores are calculated from the average score between Performance, PWA, Accessibility and Best Practice and SEO sections.

Also writes out the full json report for each site and optionally an html report too.

Lighthouse Batch v5+ requires Node v10.13+. This is a requirement from the dependency on Lighthouse v5+.


Install globally

npm install lighthouse-batch -g

Example usage

lighthouse-batch -s,

This will generate the following files under the /report/lighthouse folder.   // Full results for   // Full results from
summary.json              // Summary of results with scores out of 100

Example summary.json

    "url": "",
    "name": "www_bbc_com",
    "file": "",
    "score": "0.64",
    "detail": {
      "performance": 0.36,
      "accessibility": 0.87,
      "best-practices": 0.71,
      "seo": 0.96,
      "pwa": 0.31
    "url": "",
    "name": "housing_com",
    "file": "",
    "score": "0.71",
    "detail": {
      "performance": 0.42,
      "accessibility": 0.78,
      "best-practices": 0.93,
      "seo": 0.97,
      "pwa": 0.46

If you also want html reports include the --html option.   // Full html results for   // Full html results for

There's also the option to read site urls from a text file, one per line.

lighthouse-batch -f sites.txt


All options

lighthouse-batch [options]


    -s, --sites [sites]    a comma delimited list of site urls to analyze with Lighthouse
    -f, --file [path]      an input file with a site url per-line to analyze with Lighthouse
    -p, --params <params>  extra parameters to pass to lighthouse cli for each execution e.g. -p "--perf --quiet"
    -h, --html             generate an html report alongside the json report
    -o, --out [out]        the output folder to place reports, defaults to './report/lighthouse'
    -g, --use-global       use a global lighthouse install instead of the dependency version
    -v, --verbose          enable verbose logging
    --help                 output usage information


  • Chrome is run with the following flags to support the widest set of execution environments, including docker containers --chrome-flags="--no-sandbox --headless --disable-gpu". You can replace these with your own by passing --chrome-flags as extra parameters. e.g.

    --params "--chrome-flags=\"--no-sandbox --disable-gpu\""


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free