Stay organized with collections Save and categorize content based on your preferences.
Lighthouse is an open-source, automated tool to help you improve the quality of web pages. You can run it on any web page, public or requiring authentication. It has audits for performance, accessibility, progressive web apps, SEO, and more.
You can run Lighthouse in Chrome DevTools, from the command line, or as a Node module. Give Lighthouse a URL to audit, it runs a series of audits against the page, and then it generates a report on how well the page performed. Use the failed audits as indicators for how to improve the page. Each audit has a reference that explains why the audit is important, as well as how to fix it.
You can also use Lighthouse CI to prevent regressions on your sites.
Get startedChoose the Lighthouse workflow that suits you best:
Lighthouse has its own panel in Chrome DevTools. To run a report:
Click the Lighthouse tab.
To the left is the viewport of the web page to be audited. The right is the Chrome DevTools Lighthouse panel.Click Analyze page load. DevTools shows you a list of audit categories. Leave them all enabled.
Click Run audit. After 30 to 60 seconds, Lighthouse gives you a report on the page.
A Lighthouse report in Chrome DevTools.To install the Node module:
-g
flag installs it as a global module.npm install -g lighthouse
To run an audit:
lighthouse <url>
To see all the options:
lighthouse --help
Run the Node module programmatically
See Using programmatically for an example of running Lighthouse programmatically, as a Node module.
Run PageSpeed InsightsTo run Lighthouse on PageSpeed Insights:
Click Analyze.
The PageSpeed Insights website.To install the extension:
To run an audit:
Click Lighthouse, next to the Chrome address bar or in Chrome's extension menu. Once clicked, the Lighthouse menu expands.
The extension prompts you to generate a report.Click Generate report. Lighthouse runs its audits against the currently-focused page, then opens up a new tab with a report of the results.
A Lighthouse report generated from the extension.Use the Lighthouse Viewer to view and share reports online.
The Lighthouse Viewer Share reports as JSONThe Lighthouse Viewer needs the JSON output of a Lighthouse report. Generate the JSON outputs as follows:
shell lighthouse --output json --output-path <path/for/output.json>
To view the report data:
If you don't want to manually pass around JSON files, you can also share your reports as secret GitHub gists. One benefit of gists is free version control.
To export a report as a gist from the report:
https://googlechrome.github.io/lighthouse/viewer/
.To export a report as a gist from the CLI version of Lighthouse, manually create a gist and copy-paste the report's JSON output into the gist. The gist filename containing the JSON output must end in .lighthouse.report.json
. See Share reports as JSON for an example of how to generate JSON output from the command line tool.
To view a report that's been saved as a gist:
?gist=<ID>
to the Viewer's URL, where <ID>
is the ID of the gist. text https://googlechrome.github.io/lighthouse/viewer/?gist=<ID>
Lighthouse aims to provide guidance that is relevant and actionable for all web developers. To this end, there are two features available that allow you to tailor Lighthouse to your specific needs.
Stack packsDevelopers use many different technologies (backend, content management systems, and JavaScript frameworks) to build their web pages. Instead of surfacing general recommendations, Lighthouse provides relevant and actionable advice, depending on the tools used.
Stack packs allow Lighthouse to detect what platform your site is built on and display specific stack-based recommendations. These recommendations are defined and curated by experts from the community.
To contribute a stack pack, review the Contributing Guidelines.
Lighthouse pluginsLighthouse plugins allow domain experts to extend the functionality of Lighthouse for their community's specific needs. You can leverage the data that Lighthouse collects to create new audits. At its core, a Lighthouse plugin is a node module that implements a set of checks to be run by Lighthouse and added to the report as a new category.
For more information about how to create your own plugin, check out our Plugin Handbook in the Lighthouse GitHub repo.
Integrate LighthouseIf you're a company or an individual who is integrating Lighthouse as part of the products or services you're offering, that's great! We want as many people as possible to use Lighthouse.
Refer to the Guidelines and Brand Assets for Integrating Lighthouse to show that Lighthouse is used, while protecting our brand.
Contribute to LighthouseLighthouse is open source and contributions are welcome! Check out the repository's Issue tracker to find bugs that you can fix, or audits that you can create or improve upon. The Issues are a good place to discuss performance metrics, ideas for new audits, or anything else related to Lighthouse.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2016-09-27 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2016-09-27 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3