A wrapper around Lighthouse that allows you to ignore some audits
Last updated 2 years ago by marco-eckstein .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @marco-eckstein/lighthouse-ignore 
SYNC missed versions from official npm registry.

npm version

A wrapper around Lighthouse 3.0.3 that allows you to ignore some audits.

You can configure it to completely ignore audits and/or define a baseline of audits that allows you to tolerate failures, including thresholds for performance scores.


Lighthouse requires Google Chrome.



Lighthouse-Ignore is configured with a JSON file. Its default path is ./lighthouse-ignore-config.json. lighthouse-ignore-config.ts defines and documents its schema.


    "chromeOptions": {
    "lighthouseOptions": {
        "output": "json"
    "ignored": [
            "auditId": "geolocation-on-start",
            "justification": "The customer requires this."
    "baseline": [
            "auditId": "link-name",
            "score": 0
            "auditId": "uses-responsive-images",
            "score": 0.86
            "auditId": "first-contentful-paint",
            "score": 0.41
            "auditId": "redirects-http",
            "score": 0
            "auditId": "uses-long-cache-ttl",
            "score": 0.3


lighhouse-ignore <url>

An example output may be:

Launching Chrome and running Lighthouse audits

76 audits have been successful.

This includes the folowing audits from the baseline, which you may want to remove from the baseline now:
- link-name: Links have a discernible name
- uses-responsive-images: Properly size images: 100%

2 audits where unsuccessful but have fulfilled baseline requirements:
- first-contentful-paint: First Contentful Paint: 50%
- redirects-http: Does not redirect HTTP traffic to HTTPS

2 audits have failed:
- uses-long-cache-ttl: Uses inefficient cache policy on static assets: 23%
- uses-http2: Does not use HTTP/2 for all of its resources

See report file for details. (Opens in Chrome)


If you are happy with the command-line features of Lighthouse-Ignore, you probably have no use case for the API. It is intended for people who need something more elaborate than the provided command-line but still want to take advantage of some of its functionality in their own Lightouse wrappers.

import * as lighthouseIgnore from "@marco-eckstein/lighthouse-ignore";


const config = lighthouseIgnore.readLighthouseIgnoreConfig();
lighthouseIgnore.filterLighthouseConfig(lighthouseConfig, config);


No global modules other than npm are necessary.

  • Run npm install once after checking out.
  • Then, run either npm test for a single full build cycle (clean, compile, lint, test), or npm start for running the full cycle initially and then watch for file changes which will trigger appropriate parts of the build cycle (compile, lint, test). The watch mode is not bulletproof: It works for file updates, but you may get problems if you rename or delete files.
  • Publish with npm publish --access public. This will run the full build cycle before publishing.

Current Tags

  • 0.2.0                                ...           latest (2 years ago)

2 Versions

  • 0.2.0                                ...           2 years ago
  • 0.1.0                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (8)
Dev Dependencies (7)
Dependents (0)

Copyright 2014 - 2017 © taobao.org |