Runs the default Google Lighthouse tests with additional security tests
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
audits
bin
docs
gather/gatherers
lib
test
.editorconfig
.eslintignore
.eslintrc.js
.gitignore
.travis.yml
CONTRIBUTING.md
LICENSE
README.md
config.js
index.js
package-lock.json
package.json

README.md

Lighthouse Security Linux Build Status Coverage Status npm lighthouse-security package

Runs the default Google Lighthouse tests with additional security tests.

Lighthouse Security metrics

Lighthouse Security audits

Installation

npm install -g lighthouse-security

Run from CLI

Run the command from CLI like displayed below. The options are the same as for the default Lighthouse CLI options.

lighthouse-security <url> [options]

To run security audits only, use the --security flag:

lighthouse-security <url> --security [options]

Use in code

The extension can also be used within your code. A short example is given below. To render reports etc. it is recommended to import functionality from Lighthouse.

const runLighthouse = require('lighthouse-security')

runLighthouse(url, flags)
  .then(results => console.log(results))

Alternatively you can import just the lighthouse-security configuration and use it in your own runner:

const lighthouse = require('lighthouse')
const chromeLauncher = require('lighthouse/chrome-launcher')

// import one or more lighthouse configs:
const securityConfig = require('lighthouse-security/config')

// combine configs into one:
const config = Object.assign({},
  pageSecurityConfig,
  { extends: 'lighthouse:default' }
)

// run lighthouse as usual:
async function run(url, flags = {}) {
    const chrome = await chromeLauncher.launch()
    flags.port = chrome.port
    const results = await lighthouse(url, flags, config)
    const stopped = await chrome.kill()
    return results
}

Contributing

Contributions are always welcome. See CONTRIBUTING.md for guidelines and development scripts.

License

Apache 2.0 Licensed by De Voorhoede

↑ back to top