5.1.0 (2019-05-30)

Full Changelog

New contributors!

Thanks to our new contributors 👽🐷🐰🐯🐻! @thebengeu @boyney123

Core

gather-runner: treat NO_FCP as a pageLoadError (#8340)
logging: change log messages for gathering and trace retrieval (#9029)
tap-targets: don't exclude visible position absolute elements from audit (#7778)
budget: throw error on duplicate budget types (#8915)
config: split out config helpers (#9003)
gather-runner: always reset scroll position (reverted) (#8625)
image-elements: drop spritesheet logic (#8940)
refactor gather-runner control flow (#8964)
perf: speed up getNodePath (#9055)
performance-budget: add MP-FID as budget metric (#8905)
runner: fix missing timing properties in the browser (#9072)

Report

two rows for filmstrip on mobile (#8563)
move gauge styles to main stylesheet (#8893)
show metric descriptions by default when errors exist (#9054)
show fireworks only if all core categories score 100 (#9073)
make gauge font size and positioning dynamic (#9057)
hide 3rd party filter checkbox if all rows are 3rd party (#8966)
fix word breaking of display text, move metric disclaimer (#9030)
show nodeLabel for DOM nodes in addition to snippet (#8961)

Clients

devtools: move topbar out of scrollable container (#9077)
devtools: enable sticky header, top bar, and report ui features (#9023)
devtools: ignore dark mode media query (#9082)
devtools: update version in tests on lh roll (#8819)
lr: insert assets in lhr for logging purposes (#9002)

CLI

flags: accept comma-separated array values (#8933)

Docs

plugins: add link to field-performance plugin (#9051)
plugins: rename Google AdSpeed Insights to Publisher Ads Audit (#8906)
add lighthouse-plugin-field-performance to plugins (#9049)
add performance-budgets to related projects (#8971)

I18n

minor fr and ta translation updates (#8999)

Misc

assets: remove outdated extension screenshots (#9015)
dot-js require() everywhere (#9006)
remove unneeded reportCategories from LH.ReportResult (#9001)
update minify-trace scripts; extract to lib/ (#8968)
fix master: tmp revert of scroll change in #8625 (#9059)

Tests

lint: require file extension in require() (#9017)
update a11y sample artifacts (#9010)
remove compile-devtools on travis (#8988)
smoke: re-enable dialog prompt (#8894)

5.0.0 (2019-05-07)

Full Changelog

Major new features

Stack packs are a new way to present stack-specific advice wihin the Lighthouse report. This initial version detects if a site is running on WordPress and adds additional information to the report on how to take advantage of Wordpress plugins and configuration to improve performance. (#7243, #8169, #8633, #8536, #8778)
Performance budgets are a new feature of Lighthouse to help prevent your site performance from regressing over time. Set budgets for the resources a page should load and have Lighthouse alert if the budgets aren't met. (#8539, #8522, #8727, #8709, #8427, #8708)
The HTML report has been redesigned!

New Audits

apple-touch-icon PWA audit (#8857)
max-potential-fid (new in HTML report) (#8729, #8817)
performance-budget (#8539)
resource-summary (#8522)

Breaking changes

Node 10 (LTS) or later is now required. (#8117)
rawValue has been removed from audit results. If the audit had a meaningful numeric result (like a metric), this result will now be on numericValue. (#8343, #8385, #8421)
The accessibility category scoring has been reweighted based on severity. (#8823)
FCP accuracy has improved (in 'simulation' throttling) and may noticeably affect scores. (#7513)
The deprecated --disable-device-emulation flag has been removed. Use --emulated-form-factor. (#8289, #8334)
The dom-size now ignores elements in <head> and limits scoring to only DOM nodes in the body. (#7241)
The diagnostics audit details have had their type value changed to debugdata (#8298)
The format of the screenshot-thumbnails screenshots has changed. They are now a full image data URL. (#8299)

New contributors!

Thanks to @arnabsen, @housseindjirdeh, @MarkelFe, @muuvmuuv, and @Meggin for their first contributions!

Core

a11y: disable unused axe rules (#8373)
artifacts: create a PublicGathererArtifacts type (#8382)
runner: only pass requiredArtifacts to audits (#8760)
crc: redirects leading to iframe shouldn't be marked as critical (#6704)
driver: enable async stacks (#5504)
font-display: do not use invalid sourceURLs (#8535)
jsonld: structured data validation updates (#8137)
rect-helpers: make getBoundingRect take an array of rects (#8789)
seo: support spanish in link-text audit (#7547)
filter blob urls from more audits (#8724)
reword insecure error message (#8530)
seo: add image-alt to SEO category (#8407)
add devtoolsNodePath property to ScriptElements artifact (#8133)
always run axe gatherer last (#8216)

Report

redesign: three dots for export button (#8629)
redesign: design review feedback (#8785)
redesign: whitespace, font weights (#8820, #8891, #8592, #8591, #8531, #8528)
make v5 renderer compatible with v3 and v4 LHRs (#8822)
redesign: fireworks (#8660)
redesign: add toggle control to show metric descriptions (#8661, #8844)
add table filter for third-party urls (#6351)
redesign: remove units from table column headings (#8658))
redesign: hide sparkline in mobile (#8562)
redesign: add dark theme (#8425, #8843, #8845, #8842)
redesign: add sticky scores header (#8524, #8883)
redesign: runtime settings footer (#8229)
add missing (#8240)
redesign: new gauges, score scale, category headers, variables (#8121, #8300, #8329, #8307, #8222, #8529, #8532, #8590, #8653, #8720, #8722, #8763, #8872)
extract init() function from report-template (#8228)

Clients

devtools: remove ascii-encoded asset requirement (#8456, #8637)
lr: increase Page.getAppManifest timeout to 10s (#8350)
lr: apply, revert Lightrider timings to NetworkRequests (#8109, #8752)
psi: pass score scale element to psi (#8827)
lr: build report-generator-bundle (#8197)

Docs

update throttling (#8854)
add plugin guide (#8728)
readme: add mention of free tier of Foo integration (#8160)
readme: remove link to archived lighthouse-security project (#8141)

CLI

always handle chrome connection errors (#8583)
document that CSV is output to file (#8520)

Deps

chrome-launcher@0.10.7 (#8781)
axe-core@3.2.2 (#8370)

Tests

lightwallet: add perf-budget smoke test (#8853)
lightwallet: add budget to sample artifacts config (#8783, #8870)
add tap targets to dobetterweb sample page (#8803)
make update:sample-artifacts work for a single artifact type (#8802)
smokehouse: capture microtask regression (#8379)
smokehouse: support artifacts assertions in smoke tests (#8044)
smokehouse: fix tests from sharing artifacts (#8897)
smokehouse: change metric assertions from score to numericValue (#8805)
fix sample_v2 generation, proto errors (#8605)

I18n

import tamil translated strings (#8886)
SEO group titles and descriptions (#8719)
stack pack translations (#8154, #8415)
update seo group titles and descriptions (#8378)

Misc

proto: require protobuf 3.7.1, add stricter audit details test (#8863, #8867)
proto: remove trailing whitespace; add contributing help (#8818)
fix roundtrip sample_v2.json (#8815)
rename release scripts properly (#8751)
simplify LH.Config settings types (#8630)
add correct listitem.js @fileoverview (#8586)
update sample_v2 artifacts (#8243)
ci: build report and deploy to now.sh on every commit (#8194)
fix bad auto-merge (#8201)
update collected i18n string (#8158)
--help: remove screenshots mention from --save-assets (#8263)
lightwallet: update budget link (#8871)
fix common typos (#8726)

4.3.1 (2019-04-30)

Full Changelog

Core

support traces missing TracingStartedInBrowser (#7122)
driver: only fail security state if scheme is not cryptographic (#8338)

Clients

extension: remove github link in favor of copy to clipboard (#8294)

Deps

snyk: update snyk snapshot (#8354)

Misc

add releasing scripts (#8387)

4.3.0 (2019-04-08)

Full Changelog

New contributors!

Thanks to @rdlabo and @yashrajbharti for their first contributions!

Report

include utm params in links to docs (#7441)
fix PWA badge from disappearing on scroll (#7512)

Core

artifacts: rename Scripts to ScriptElements artifact (#7920)
canonical: move canonical audit to LinkElements (#7080)
font-display: handle carriage returns (#7712)
font-display: ignore data URLs (#7684)
image-aspect-ratio: ignore css background images (#7516)
jsonld: add structured data validation (#6750)
lhr: truncate measure timings to hundredths (#7748)
logging: don't log when closing already closed page (#7576)
main-thread-tasks: improve event-order error messages (#7745)
main-thread-tasks: handle last task not finishing (#7728)
main-thread-tasks: use toplevel tasks in main thread audit (#7711)
oopif: attach to all descendants (#7608)
oopif: skip OOPIF network records in some gatherers (#7640)
optimized-images: cap execution to 5 seconds (#7237)
settings: add lighthouse channel (#7312)
remove hreflang gatherer (#7477)
tap-targets: exclude sticky elements from tap targets audit (#7603)
vuln-libs: match against all semver ranges provided by snyk (#7402)
uses-http2: ignore requests from service-worker (#7197)

Docs

add plugin recipe (#6965)
readme: Foo integration (#8035)
url-shim: add comment about public suffix lst (#7671)

Clients

devtools: refactor build script (#7421, #7567)
lr: always use transferSize from X-TotalFetchedSize header (#7478)
lr: gather network timing numbers from headers (#7888)
lr: add custom config support (#7613)

Tests

better fatal trace logic error coverage (#7959)
fix test coverage generation (#7475)
finish removing mocha (#7429)
upgrade jest to fix current node 11 build (#7413)
smoke: remove trivial uses of rawValue from expectations (#7780)
smoke: set Content-Type for files served by static-server.js (#7612, #8015, #8078)

Misc

chore: remove old dep postinstall-prepare (#7647)
remove unused typedef (#8075)
specify types for some dependency-graph options objects (#7962)
simplifications in simulator/connection-pool (#7894)
drive-by code cleanup in BaseNode (#7723)
remove lhr-lite.d.ts (#7991)
remove obsolete Util.formatDisplayValue (#7628)
various spelling fixes (#7370, #7492, #7427)
fix unit-viewer command for windows (#7624)
remove obsolete unused files (#7476)
cli: add --plugins flag to load from the command line (#7407)
gather: update comment re: ClientRect copying (#7785)

Deps

update nyc to latest (#7431)
snyk: update snyk snapshot (#7392, #7589, #7943)

I18n

Hindi for seo and a11y (#7786, #8070)
add new translations for SEO; updates for a11y and perf (#7720)

4.2.0 (2019-03-06)

Full Changelog

New contributors!

@pra85, @tgfjt, @gidztech and @jburger424. Thank ya!

New Audits

tap-targets: verify tap targets are well sized and distinct (#5846)

CLI

write report in runLighthouse before quitting Chrome (#7339)

Core

fid: add Max Potential FID to JSON (#5842)
artifacts: unify AnchorElements into single gatherer (#7101)
artifacts: include inline scripts in Scripts artifact (#7065)
artifacts: create ViewportMeta computed artifact (#7264)
artifacts: add TestedAsMobileDevice base artifact (#7280)
bootup-time: better attribution (#7059)
byte-efficiency: use more optimistic GZIP ratios (#7210)
cache-headers: fix typo in must-revalidate (#7189)
details-renderer: add snippet details renderer (#6999)
diagnostics: add diagnostic audits (#7052)
driver: add waitForFCP timeout (#7356)
driver: collect network requests from out-of-process iframes (#6922)
driver: add ' Chrome-Lighthouse' to useragent (#7297)
emulation: bump chrome useragent to m74 (#7211)
fcp-3g: remove unused i18n for LR compatibility (#7103)
font-display: more accurately follow CSS spec (#7191)
image-elements: cap natural-size fetch time (#7274)
lantern: add configuration for precomputed network analysis (#7239)
lhr: include resourceSize in network-requests audit (#7056)
manifest: remove Manifest artifact in favor of new WebAppManifest (#7078)
metrics: do not fail if TTI fails (#7132)
network-analysis: set additional RTT to 0 not NaN (#7156)
network-recorder: redirects started by script are set as initiators (#7352)
plugins: add support for groups (#7304)
seo: remove manual mobile-friendly audit (#7223)
seo: add rel=canonical test for auditing a domain root (#7228)
tap-targets: disable font size and tap targets audit on desktop (#7393)
tap-targets: make tap targets failures more visible (#7373)
tsc: fix audit details type hierarchy (#7177, #7154, #7285)
unused-css: change title Defer -> Remove (#7235)
give sort fallback for broken test details in node 11 (#7216)
suppress protocol timeout for app manifest bug in LR (#7184)
optimize tap-targets audit (#7130)
remove NO_ERROR runtimeError when no error (#7358)

Deps

snyk: update snyk snapshot (#7277, #7233, #7167, #7116)
updates to weed out transitive vulnerabilities (#7319)
update cssstyle to parse more named colors, CSS4 colors (#7283)

Docs

contributing.md: fix typos (#7170)
fix throttling rate comment and tweak comcast bandwidth (#7374)
improve explanations of extending and using config files (#7354)
update throttling docs to public version (#7332)
readme: add lighthouse-keeper to integrations (#7399)
docs(related-projects) add react-lighthouse-viewer (#7262)
readme: Add Fluxguard to the list of integrations (#7249)
variability: add dedicated variance doc (#7175)

I18n

fix max potential FID description (#7353)
ICU syntax correction (#7320)
seo strings prepped for i18n (#6860)
translate strings in the tap-targets audit (#7111)
a11y category title and description (#7113)
import translated accessibility and lh-error messages (#7008)

Report

reorganize a11y audit groups (#7129)
clip exceptionally long URLs in the header (#6858)
details-renderer: use new audit-details types (#7192)

Tests

refactor driver, more gotoURL tests (#7270, #7242, #7212)
run node 11 in CI (#7230)
replace non-volatile snapshots with inline literals (#7217)
smokehouse: refactor to enable Smokerider (#7284)
smokehouse: +/- operator (#7343)
smokehouse: gzip test to assert transfer and resource sizes (#7286)
smokehouse: fail on finalUrl/errorCode mismatches (#7227)

Misc

tap-targets: remove lines with trailing whitespace (#7105)
clean node_modules/.cache before travis builds its cache (#7388)
convert Flags comments to jsdoc for better intellisense (#7359)
export UA strings from emulation.js (#7318)
fix typo in comment (#7296)

4.1.0 (2019-01-28)

Full Changelog

New contributors!

@castilloandres you da man, man.

Core

font-size audit: count code points for text length (#6973)
cache headers audit: ignore private, must-validate, no-cache (#6835)
introduce Lighthouse plugins (#6959)
new audit: add FCP on 3G (#7062)

Refactor

refactor meta element artifacts to single meta-elements artifact (#7025)
images: cleanup ImageUsage to match other *Elements artifacts (#7030)
add baseArtifacts (with new WebAppManifest) to passContext (#6957)
use async/await in evaluateAsync (#7038)

Report / Viewer

renderer: do not attempt fireworks for devtools (#7090)
viewer: allow loading RunnerResult json (#7031)

Misc

readme: Add DebugBear to the list of integrations (#7036)
snyk: update snyk snapshot (#7079)
viewer: fix types to reference LH.Result (#7051)
replace TODOs with github issue links (#7049)
fix extension package path and viewer comments (#7032)

4.0.0 (2019-01-16)

New contributors!

@mattzeunert, @dima74, @jeffbcross, @knoxmic, and @shogunsea. Thanks!

Major changes

A bevy of bug fixes and performance improvements.
A special reward for getting a perfect score.
A new layout for the PWA category, emphasizing speed, installability, and polish.

Breaking changes

New PWA category, organization, and scoring (#6395)
- the PWA section of the report has a set of badges instead of a numeric score gauge (#6526, #6670)
- the webapp-install-banner audit is now installable-manifest (#6630)
- the offline check formerly in webapp-install-banner is the new audit offline-start-url (#6397)
audits' scoreDisplayMode 'not-applicable' is now 'notApplicable' (#6783)
no-websql audit removed due to performance cost (#6293)
speed-index scoring now scales based on throttling (#7007)
empty children arrays are now removed from critical-request-chain audit result (#6211)
the correct Nexus 5X screen height of 660 now used instead of 732 (#6932)
throttling constants under mobile3G renamed to the more accurate mobileSlow4G with no change in values (#6163)
typescript definition files are now located under types/ (#6617)
computed artifact files are now located under lighthouse-core/computed/ (#6618)

Full Changelog (in addition to the changes in 4.0.0-beta, 4.0.0-alpha.1, and 4.0.0-alpha.0)

Core

config: reorder categories to match new score gauge order (#6848)
driver: handle navigation rejections within Driver.gotoURL (#6739)
driver: exit early when testing page with insecure certificate (#6608)
driver: waitForFCP when tracing (#6944)
handle invalid network timing data (#6780)
fix usesObjectFit property for ImageElement (#6761)
fonts: resolve URLs relative to stylesheet (#6782)
lantern: remove unnecessary sort calls (#6900)
lantern: drop node id from error message (#6774)
minification: properly handle regex character classes (#6745)
preconnect: add warning if preconnect link is not used (#6694)
preload: warn when duplicate requests issued (#6849)
scoreDisplayMode: change 'not-applicable' to 'notApplicable' (#6783)
service-worker: check that start_url is within SW's scope (#6678)
speedindex: scale scoring coefficients based on throttling (#7007)
tap-targets: helper functions for working with ClientRects (#6703)
url: add intent protocol to NON_NETWORK_PROTOCOLS (#6711)
user-timings: move into computed artifact (#6719)
change displayValue to be string only (#6767)
add type checking to pwmetrics-events (#6980)
stricter LR-desktop metric scoring (#6969)
in-page functions refactor (#6702)

Deps

update axe-core to latest (#7020)
update details-element-polyfill to 2.2.0 (#6928)
update tsc to 3.2.2 (#6684)
snyk: update snyk snapshot (#6888, #6842)

Docs

readme: add speedrank to integrations list (#6987)
readme: added simple guidance on install options (#6810)
configuration.md: update link to pwmetrics (#6816)
scoring: update TTI references (#6865)
--help: use HTTPS link to bit.ly/chrome-flags (#6692)
ask people to test a11y issues upstream first (#6764)

Extension

return runnerResult from runLighthouseInExtension() (#6839)

I18n

localize LighthouseError messages (#6457, #6812)

Report

pwa: add tooltip to badge gauge (#6689)
add top-level section for passed audits that had warnings (#6989)
celebrate all 100s (#5455)
expand groups within "Passed Audits" by default (#6930)
fix margin on score gauge wrappers (#6948, #6972)
support narrow screens (#6857)
larger margins for audit group summaries (#6688)
clean up more clump/group/expandable cruft (#6982)

Tests

smokehouse: assert errorCode in expectations (#6851)
smokehouse: use node's native URLSearchParams (#6929)
add type checking to cli/tests/ (#6874)
report: restore old, disabled failed grouping test (#7006)

Misc

descriptions: more accurate metric descriptions (#6508)
emulation: use correct Nexus 5X screen size (#6932)
snyk: only keep vuln data for detectable libs (#6919)
clean up local names within Config (#6950)

4.0.0-beta (2018-11-29)

Full Changelog

Core

service-worker: check that test page is in SW scope (#6609)
throw fatally on page hang (#6497)
define new DNS failure LH Error (#6579)
assert securityIssues before getPageLoadError (#6578)
remove protocol timeout for Page.navigate (#6413)
rename webapp-install-banner audit to installable-manifest (#6630)
computed-artifacts: fix cache and add perf timing (#6619)

Report

add PWA category badge gauge (#6526, #6670)
give passed-opportunities group an icon (#6594)
safari: fix dropdown overlap translateZ (#6546)
use details-element-polyfill from node_modules (#6593, #6607)

CLI

exit and kill Chrome on unhandledRejection (#6394)

Tests

add smoketest for slow service worker (#6648)

Misc

tsc: infer dom.createElement type from tag name (#6637)
rename core/gather/computed/ to core/computed/ (#6618)
rename typings/ to types/ (#6617)
bump extension version (#6569)

4.0.0-alpha.1 (2018-11-15)

Full Changelog

Core

skip h2 audit in LR (#6564)
config: faster category validation (#6445)
driver: wait for Page.frameNavigated for about:blank (#6446)
lib: add chrome-extension to URL allowedProtocols and add test (#6447)
pwa: audit and report group renames (#6494)
seo: properly handle anchors in SVG (#6483)
increase protocol timeout to 30s (#6505, #6531)

Report

pwa: give badges to groups with all passing audits (#6504)
pwa: add pwa-category-renderer (#6486)
compat: add details-element polyfill for Edge (#6465)
compat: fix support for edge (#6459)
compat: ignore Edge's Invalid Argument error (#6456)
compat: fix summary rendering in FF (#6448)
handle underscored not_applicable scoreDisplayMode (#6549)
css: make performance category more compact (#6437)
rename clump classes; give classes to all audit groups (#6482)
refactor rendering of top-level failed/passing/etc clumps (#6460)

Misc

build: fix viewer deploy (#6449)
timing: move timing-trace to async events (#6440)
update puppeteer to version 1.10.0 (#6493)
readme: use official appveyor badge (#6443)
i18n: convert accessibility audits (#6229)

4.0.0-alpha.0 (2018-10-31)

Full Changelog

New Contributors!

Thanks to @carlesnunez and @justin0022 for their first contributions!

Thanks to @CodeDem for improving how the image-aspect-ratio audit handles small images!

Huge thanks to myself (@Hoten) for joining Lighthouse! Go me!

New Audits

offline-start-url (#6397)

Core

aspectratio: ignore placeholder images (#6305)
audit: add utm parameters when calling snyk (#6172)
audits: clarify diff between load-fast-enough-for-pwa's TTI and perf TTI (#6286)
axe: disable unused audits (#6180)
computed: fix new computed artifact interface (#6151)
config: add new PWA category groups (#6396)
critical-request-chain: remove empty children from LHR (#6211)
driver: save performance.now() to avoid conflict (#6387)
driver: request smaller trace in m71+ (#6117)
driver: stringify protocol error messages (#6302)
driver: address bckenny feedback on #6117 (#6285)
driver: reduce required traceCategories again (54baf91)
driver: recover from rejection on handleJavaScriptDialog (#6327)
emulation: fix missing space in mobile UA (#6161)
icons: defer to manifest-icon type hint for image type (#6230)
network: handle invalid NetworkRequests (#6157)
network-analyzer: move throughput to NetworkAnalyzer (#5900)
perf: add timing instrumentation to measure runtime perf (#3745)
proto: add proto definition for LHR (#6183)
simulator: start nodes in observed order (#5362)
unminified-javascript: replace esprima with custom tokenizer (#5925)
remove recoverOrThrow / err.fatal (#6343)
convert computed artifact loading to regular require() (#6204)
remove no-websql audit (#6293)
bail on run if insecure ssl certification (#6300)
make throttled offscreen-images work without TTI (#6039)
save HTMLElement.p.matches function to avoid conflict (#6283)
remove fonts gatherer, move font-display to use CSSUsage artifact (#6166)
remove last dependency on WebInspector (#6209)
add timeout to all protocol commands (#6347)
don't load blank page twice in first pass (#6369)
refactor finding of trace start (#6370)
increase Page.navigate timeout (#6412)

Report

fix tooltip hover animation (#6288)
reframe Fast 3G as Slow 4G (#6163)
fix html report viewing bugs for Safari (#6143)
dom-size: right-align the value column (#6372)

Clients

simplify viewer build process (#6426)
reorganize file structure and build process (#6344)
build: ignore all locales from devtools & extension build (#6170)
lr: skip early emulation now that lr-desktop is defined (#6158)
split browserifying and extension packaging into separate scripts (#6295)
simplify bundle building (#6282)
stop report bug prompt for file:// urls (#6278)

Deps

update typescript to latest patch release (#6235)
update to tsc 3.1.1 (#6126)
jsdom: upgrade to support Element.prototype.closest (#6411)
snyk: update snyk snapshot (#6377)

Docs

contributing: consistent capitalization (#6174)
new-audits: revise issue template (#6233)
readme: Add new related project, lighthouse-github-reporter (#6307)
readme: change image references be commit hash raw gh urls (#6116)
add primer on viewing the timing data (#6393)
typo fix (#6335)
Remove "sh" format for CLI --help output (#6311)
update docs for --output-path re: multiple output types (#6339)

I18n

roll latest messages from TC (#6388)
update test for new canonical locale codes (#6360)

Tests

use predictable numbers in golden LHR (#6404)
add basic sentry tests (#6308)
restore lr-entry test (#6214)
remove more mock computed artifacts (#6195)
add trace creator (#6196)
add networkRecord-to-devtoolsLog mocking utility (#6171)
add angular test for JS minification (#6138)
run node 10 on Travis (#6361)

Misc

tweaks for devtools client (#6127)
simplify proto npm scripts (#6406)
add cli module diagram (#6129)
keep download-chrome script in npm package (#6153)
lantern script path resolution fix (#6380)
add integrity data to yarn.lock (#6212)
add yarn integrity hashes for extension/viewer (#6277)
only allow 1 error from each audit/gatherer (#6215)
Revert "core(driver): stringify protocol error messages (#6302)" (#6328)
fix typo in feature request template (#6431)
remove plots/ (#6346)
build: cleanup extension package zip using gulp (#6210)
build: rename bundled files (devtools/ext/lr) (#6179)
eslint: enforce infix-op spacing (#6382)
logger: isVerbose(), getTimeEntries() (#6383)
logging: add hanging request logging in driver (#6297)
proto: made default LighthouseError enum 'UNDEFINED' (#6334)
proto: align proto whitespace (#6374)
proto: convert int32's into DoubleValue in proto (#6332)
proto: adjust configSetting.output in preprocessor (#6310)
proto: add audit_mode and timings (#6363)
proto: fix linting and add LR hook (#6373)
proto: make NO_ERROR default in proto (#6358)
proto: reduce configSettings in proto to minimum (88b2829)
yarn: update lockfile for micromatch (#6384)

3.2.1 (2018-10-01)

Full Changelog

Core

emulation: set desktop viewport to 1350x940 (#6131)
await js-libraries detection (#6141)

3.2.0 (2018-09-27)

Full Changelog

New Audits

add js-libraries audit, just listing detected js libs (#6081)

Faster

driver: deliver trace as events rather than a stream (#6056)
network-recorder: consider iframe responses finished. helps avoid pageload timeout (#6078)
replace WebInspector traceparser with native JSON.parse (#6099)

Core

add emulatedFormFactor setting (#6098)
remove some trivial uses of WebInspector (#6090)
use cssstyle to parse CSS colors instead of WebInspector (#6091)
initial refactor of computedArtifact import/caching (#5907)
asset-saver: stop creating screenshot files during --save-assets (#6066)
content-width: not applicable on desktop (#5893)
driver: add check to make sure Runtime.evaluate result exists (#6089)
icons: Add PNG check to manifest icon validation (#6024)
lhr: add top-level runtimeError (#6014)
- gather-runner: include error status codes in pageLoadError (#6051)
- smooth rough edges of pageLoadError display and reporting (#6083)
net-request: transferSize now shared via 'X-TotalFetchedSize' (#6050)
don't allow analysis of file:// urls (#5936)

Report

dont show zero ms savings in preconnect, preload audits (#5983)
align table headings & columns left/right (#6063)
audit: make dom-size table prettier (#6065)
cursor:pointer on Passed Audits, etc (#5977)
psi: remove redundant varience disclaimer (#6110)
util: ✅ audits should be in Passed Audits (#5963)
vulnerable-jslibs: tweak snyk link for highlighted matches (#6096)
xbrowser: replace Typed OM getComputedStyle() with CSSOM equivalent (#5984)

CLI

add --print-config flag (#6107)

Deps

snyk: update snyk snapshot (#6074)
chrome-launcher@0.10.5 (#6106)
js-library-detector@5.1.0 (#6102)
speedline@1.4.2 (faster sort) (#6073)
chrome-devtools-frontend@latest (#6101)

Docs

readme: add lighthouse4u (#6008)
readme: updated report screenshot to 3.1.0 (#6042)
readme: add lighthouse-badges to related projects (#5969)
recipes: update custom-audit package.json (#6007)
releasing: minor updates (#5345)

i18n

roll latest strings from TC (#6109)
mv locale files (#5981)
speed up replacement regex (#6072)

Misc

bump bundlesize threshold a little more (#6055)
runner: added locale to settings that can change between -G and -A (#6080)
tsc: add type checking to sentry usage (#5993)

3.1.1 (2018-09-07)

Full Changelog

update report score legend to match updated color buckets (#5985)

3.1.0 (2018-09-06)

Full Changelog

New Contributors!

Huge thanks to @midzer and @justinribeiro for being so darn helpful. Great stuff. :D

And thanks to @mettamatt for some helpful documentation. Who doesn't love better docs?!

Notable changes

red/orange/green color buckets for scores are tougher now. (#5831)

	Previously	Now
Red (bad)	0-44	0-49
Orange (average)	45-74	50-89
Green (good)	75-100	90-100

Scoring itself hasn't changed; only what color is used to decorate a score.

trace-processor: fix bug where top-level events weren't being found in the trace (#5841)

Core

normalize URL before checking equality (#5960)
expose LighthouseRunWarnings on audit context (#5684)
adjust audit titles for consistency (#5717)
export any page-functions as string (#5902)
all ByteEfficiency audits require a trace (#5840)
enhanced noopener output (#5857)
errors: class rename and re-source page load errors (#5972)
fix defaultConfig UIStrings and exit code for test (#5884)
remove last debugString references (#5856)
redirects: update redirects to use OpportunityDetails (#5791)
warn when extensions affected perf (#5666)
driver: handle when page redefines global.URL (#5748)
gather-runner: call clearDataForOrigin on teardown (#5933)
lhr: expose environment info (#5871)
lr: add LR presets for desktop and mobile (#5886)
lr: drop maxWaitForLoad 45 -> 35 (#5938)
network: handle LR transferSize (#5895)
network-analyzer: infer RTT from receiveHeadersEnd (#5694)
optimized-images: support non-standard mime types (#5688)
preload: remove CRC dependency (#5901)
screenshot-thumbnails: improve caching (#5976)
ttfb: reuse requestMainResource (#5657)
trace-of-tab: only use navstart of chrome/http documents (#5917)
tracing-processor: throw on no top level events (#5878)
uses-long-cache-ttl: handle multiple cache-control headers (#5745)

Extension

access core through module instead of Runner (#5855)
tweak runLighthouseAsInCLI jsdoc (#5812)
refactor option/flag passing (breaking change) (#5769)
remove X-UA-Compatible meta (#5739)
popup: keep feedback class (#5872)

i18n

add i18n 'type' for prlint (#5880)
minor message and description changes based on translator feedback (#5829)
reframe the ICU message descriptions with placeholders (#5737)
export rendererFormattedStrings (#5713)
extract performance category strings to UIStrings (#5716)
always use english for status logs (#5727)
add 'ln' locale which maps to 'fr' (#5879)
support descriptions (#5718)
add [ICU Syntax] label to relevant message descriptions (#5736)
import psuedo-locale json from TC (#5726)
incorporate 52 languages into messages pipeline (#5781)
add descriptions to UI strings (#5743)
add strings of the opportunity group split (first paint, overall) (#5744)
add locale fallback when language not supported (#5746)
localize strings at end of run (#5655)
always use formatted strings for extension popup (#5761)
add strings for user timing entries table (#5806)
sort the ICU messages when saved (#5771)
roll latest TC messages (#5802)
add localized messages for 52 locales (#5780)
add assertion script (#5686)
report: use LHR locale for toLocaleString (#5734)
report: localize CRC renderer strings (#5730)

Types

don't use index signature in LHErrors (#5896)
type check config files (#5858)
don't use index signature in simulator.js (#5897)
update debugger protocol type checking (#5836)
remove more reliance on implicit index signatures (#5874)
update types in emulation.js (#5830)
tighten traceOfTab timing types (#5887)
update to ts 3.1 to support new protocol defs (#5942)
update to latest tsc (#5581)
NetworkRequest.RESOURCE_TYPES type fix (#5851)
add explicit index signature in mainthread-work-breakdown (#5859)
cli: make LH.Flags type correct and consistent (#5849)

Report

link to our own "unused css" reference doc (#5698)
expose prepareLabData directly as a fn (#5818)
responsive styles (#5706)
add PSI.prepareLabData() (#5804)
adopt 80-char line-length license (#5757)
add method to get the final screenshot (#5673)
metrics: display metrics in seconds (#5914)
psi: add Util.prepareReportResult method (#5766)
psi: reset template styles on every call of prepareLabData (#5877)
psi: add lab data summary sentence (#5961)

New Audits

a11y: add manual audit for interactive element affordance (#5764)

Tests

quiet down collect-scripts during CI (#5801)
better display value tests with i18n (#5720)
dbw: remove createShadowRoot call (#5906)
jest: disable coverage collection by default (#5772)
smokehouse: update expectations for HTML Imports deprecation (#5943)
smokehouse: update passive listener expectations (#5899)

Deps

snyk: update snyk snapshot (#5774), (#5773), (#5762), (#5691)
depend on speedline-core, rather than the cli (#5800)

Docs

headless: Require Node 8 and apt install chromium (#5974)
headless: example script to post report as gist (#5975)\
integrations: Add SpeedCurve to "Lighthouse Integrations" (#5732)
link FCP audit description to lighthouse docs (#5850)
puppeteer: remove appMode mention (#5923)
readme: mention chrome-flags troubleshooting in getting started (#5916)
report: add a renderer readme (#5725)
scoring: http2 redirect PWA score issue (#5929)

Misc

cli: enableErrorReporting must be undefined by default (#5854)
asset-saver: tweak output format of logAssets (#5696)
logger: add time/timeEnd methods (#5905)
fix grocers apostrophe typo (API's v APIs) (#5948)

3.0.3 (2018-07-17)

Full Changelog

Core

emulation: use setTouchEmulationEnabled (#5661)
response-compression: graceful recovery (#5578)
simulator: add DNS timing (#5607)

Misc

convert strings to NetworkRequest.TYPES (#5674)
sentry: lower "could not load stylesheet" sampling to 0.01 (#5677)

3.0.2 (2018-07-11)

Full Changelog

New Contributors!

Thanks to @schalkneethling and @eduardosada for their first contributions!

New Audits

assert a present and valid doctype (#5274)

Core

fonts: bump gatherer timeout to 5s (#5643)
network-request: cleanup DevTools property names (#5606)
preload: remove blob protocol from preload audit (#5409)
without-javascript: allow noscript pages (#5571)

Docs

architecture: add diagram of module dependencies (#5615)
custom-audit: update custom-audit to 3.0.0 api (#5612)
[minor] issue template tweaks (#5641)

Extension

fix "extension Error: couldn't resolve current tab" (#5591)
3.0.0 as well (#5584)

Tests

[minor] rename robots.txt test file (#5610)
run the golden LHR check earlier (#5609)

Misc

scripts: more succinct lantern output (#5523)

3.0.1 (2018-07-02)

Full Changelog

Core

fonts: handle CORS cssRules (#5592)

Tests

adopt jest (leaving mocha) for core & cli (#5386)

3.0.0 Final (2018-06-29)

Changelog of v3.0.0-beta.0 to 3.0 final

New Contributors!

Thanks to @underbyte, @nourikhalass and @ernstmul for their first contributions! Awesome stuff.

Core

a11y: add back html/tags/impact (#5439)
audit: align meta properties with LHR (#5540)
audit-mode: do not require a URL (#5495)
driver: [minor] fix spelling of evaluate (#5553)
fcp: fix scoring curve (#5507)
image-aspect-ratio: loosen ratio check (#5358)
lhr: migrate opportunity details to new format (#5296)
main-resource: work with hash URLs (#5422)
multi-check: expose manifest checks in details (#5405)
network-requests: handle negative endTime (#5530)
offscreen-images: add lantern filter (#5361)
opportunities: more granular score (#5331)
preload: only allow same origin (domain + subdomains) (#5065)
pwa: revamp and move short_name_length audit (#4860)
pwa: adjust score weights (#5233)
faster saveTrace by streaming 500 events at a time (#5387)
convert requestIds before sending to backend (#5580)
remove dependency on DevtoolsTimelineModel (#5533)
remove no-mutation-events audit (#5509)
remove WebInspector.resourceTypes references (#5556)
[minor] migrate remaining .description -> .title (cee9d55)
support traces with TracingStartedInBrowser event (#5271)
remove dependency on devtools-frontend NetworkRequest (#5451)
convert gather-runner.js to async/await (#5462)
handle DOM.resolveNode errors (#5427)
split out BaseArtifacts, those always provided by LH itself (#5506)
simulator: convert node timings to trace (#5350)
simulator: improved timing typedef (#5347)
trace-of-tab: remove DevTools stableSort dependency (#5532)
traces: move findTracingStartedEvt to tracingProcessor (4826a77)
tsc: make CPUNode and NetworkNode a discriminated union (#5548)
tsc: use Config class to define Config type (#5525)
tsc: add initial trivial type info to config.js (#5481)
tsc: refactor config.js (and add type checking) (#5486)
tsc: migrate renderer & viewer off typedefs to .d.ts (#5342)
user-timings: add back startTime (#5442)

Deps

bump gulp's natives dep for node 10.4 compat (#5497)

Docs

update required chrome version (#5425)
update docs for v3 (#5357)
audit: add jsdoc descriptions to the audit meta properties (#5567)
readme: lighthouse-ci (#5410)
scoring: update metric explanations (#5528)

Extension

popup: integration test for popup (#5412)
tsc: add type checking to extension entry points (#5346)
expose devtools hooks reliably (#5579)
allow use of ES2018 features (#5377)
update minimum Chrome version to 66 (#5403)
close the popup once the report has opened (#5341)

Tests

lantern: add lantern regression test scripts (#5435)
fix golden LHR (#5529)
smoke: remove console.timeline() call (#5560)

Misc

externs: import crdp from root node_modules (#5366)
golden-lhr: exclude audit descriptions (#5538)
scripts: more useful lantern debugging output (#5517)
viewer: load *.json if no *.lighthouse.report.json (#5343)
update codeowners file (#5564)
move metrics into dedicated metrics/ folder (9def0a6)
needs NPM as well as Node installed (114ebf5)
add links to lighthouse docs (c7304a7)

3.0.0-beta.0 (2018-05-24)

Full Changelog

Core

lantern: handle disk cache simulation (#5221)
network-recorder: handle QUIC requests (#5256)
tsc: add type checking to viewer (#5258)
tsc: add tsc type checking to report (#5195)

Deps

snyk: prettify snyk snapshot (#5080)

Docs

readme: add Garie to related projects (#5272)

Extension

expose URL shim (#5293)
another speculative fix for getCurrentTabURL; more logging (#5323)

Report

updates for devtools roll (#5326)
audit warnings are no longer top-level (#5270)
move runtime settings to footer (#5295)
avoid paint storms on scrolly header (#5207)
restore missing non-applicable icon (#5267)
animated chevrons (#5137)
DRY up audit & opportunity rendering (#5136)

Misc

github: add github PR and issue templates (#5163)
plots: extend default config (#5309)
scripts: add lantern evaluation scripts (#5257)
scripts: add trace/devtoolslog minification scripts (#5237)
viewer: fix saving as gist (#5251)
remove checkboxes from bug report template (#5330)

3.0.0-alpha.2 (2018-05-16)

Full Changelog

Core

lhr: audit id, title, description (#5190)
lhr: revert default wait bump (06205ef)
uses-preload: prevent infinite loop (#5184)
violation-audit: de-dupe items by URL and label (#5219)

Docs

readme: add lighthouse-lambda to related projects (#5227)

Report

dom-size: use correct learn more link (#5192)
header: fix stacking contexts within header (#5185)
minimum time scale for opportunities & filmstrip (#5183)

Tests

compile: fix broken compile-devtools script (#5234)
viewer: upgrade pptr to handle new CSSOM use in the report (#5191)

Misc

npmignore: include chrome launcher script (aa0e089)
viewer: switch to 2x viewer within the same tab (#5231)
viewer: support legacy 2.x reports in viewer (#5204)
closure cleanup in viewer from #5231 (#5235)
3.0.0-alpha.1 (c7c0044)

3.0.0-alpha (2018-05-09)

Full Changelog

New Audits

robots-txt: /robots.txt validation (#4845)
efficient-animated-content, use videos instead of gifs (#4885)
add preconnect audit (avoid costly origin roundtrips) (#4362)

CLI

chore: remove chrome-launcher stubs (#4945)
output: Add ability to export results to CSV (#4912)
update documented throttling flags (#5000)

Core

byte-efficiency: use lantern for opportunity estimates (#4601)
canonical-audit: allow multiple identical canonical links (#4973)
category: add manualDescription (#5100)
computed-artifact: remove requiredNumberOfArtifacts (#4764)
config: add support for audit/gatherer options (#4394)
config: remove config.artifacts; always use auditMode (#4986)
config: clean flags for config settings (#4960)
config: augment settings/passes with defaults (#4894)
config: switch to throttling settings object (#4879)
config: switch to lantern by default, add presets (#5041)
critical-request-chains: exclude preloaded requests from crc (#5011)
displayValue: fancier displayValue type (#5111)
domstats: useIsolation within domstats (#4811)
driver: add timeout to getRequestContent (#4718)
emulation: update Chrome userAgent to 66 (#4779)
estimated-input-latency: use a 5s rolling window (#4989)
fast-config: bring back a11y & SEO categories (#4932)
font-size: recalibrate the legible font sizes (#4550)
http-redirect: drop use of getSecurityState() to gain Android support (#4661)
image-usage: use min of resourceSize/transferSize (#4968)
img-usage: handle invalid images within determineNaturalSize (#4812)
is-crawlable: fix empty row in the details table (#4820)
is-crawlable: determine if page indexing is blocked by robots.txt (#4548)
is-on-https: consider about:* secure (#4749)
lantern: cleanup Simulator construction (#4910)
lantern: more flexible graph edge creation (#4933)
lantern: move metrics to computed artifacts (#4766)
lantern: improve RTT estimates (#4552)
lantern: use securityOrigin on record (#5071)
lantern: never exclude main document from graphs (#5124)
lantern: rename Simulation.Result.nodeTiming to be plural (#5038)
lhr: eliminate cards and list details (#4789)
lhr: convert reportCategories to categories object (#5155)
lhr: support printf displayValues (#5099)
lhr: rename perf-hint, perf-info, etc (#5102)
lhr: make reportCategories shallow; move audit scores to AuditResult (#4711)
lhr: support null scores (#5128)
lhr: s/initialUrl/requestedUrl, s/url/finalUrl (#5127)
lhr: s/audits/auditRefs, s/category.name/category.title/ (#5157)
lhr: strictly numeric scores, add scoreDisplayMode (#4690)
lhr: move runtime config to report => lhr.configSettings (#5122)
lhr: remove extendedInfo (#5160)
lhr: drop informative/manual, moving them to scoreDisplayMode (#5105)
lhr: overhaul LHR details, introduce details.summary (#4616)
lhr: remove debugString, add explantion/errorMessage (#5132)
lhr: s/fetchedAt/fetchTime (#5112)
lhr: lhr-lite type declaration (#4983)
lhr: overallSavingsMs, overallSavingsBytes (#5035)
load-fast-4-pwa: use computed artifacts (#4981)
main-resource: adjust main resource identification logic (#4475)
mainthreadwork: multiply by cpuSlowdownMultiplier (#5126)
metrics: consumable metrics audit output (#5101)
metrics: move TTCI to computed artifact (#4943)
metrics: switch to speedIndex from perceptualSpeedIndex (#4980)
metrics: add lantern speed index (#4695)
metrics: update lantern coefficients (#5120)
metrics: move first-interactive to first-cpu-idle (#4982)
metrics: rename ConsistentlyInteractive -> Interactive (#5068)
metrics: add lantern EIL (#5024)
metrics: add FCP metric (#4948)
metrics: add first CPU idle lantern metric (#4966)
metrics: move FMP to computed artifact (#4951)
network-analyzer: more distrustful of chrome connection info (#4828)
network-recorder: fix typo in once() call on super (#4926)
response-compression: also check x-original-content-encoding (#4607)
unify config and CLI settings (#4849)
network-requests: add resource type (#4743)
network-requests: add network requests audit (#4631)
noopener-audit: allow noreferrer as well (#4920)
opportunities: take max of savings on TTI, load (#5084)
preconnect: use lantern to compute savings (#5070)
preload: use lantern to compute savings (#5062)
redirects: use lantern to compute savings (#5081)
render-blocking: address followup feedback (#5039)
render-blocking: handle amp-style stylesheets (#4555)
runner: split lhr, artifacts return, respect output type (#4999)
runner: support multiple output modes (#5154)
runner: add custom folder support to -G/-A (#4792)
runner: rename generatedTime to fetchedAt (#4783)
scoring: tweak performance weights (#5083)
scoring: loosen metric thresholds (#5092)
scoring: tweak scoring thresholds based on HTTPArchive data (#5022)
screenshots: align filmstrip to observed metrics (#4965)
seo: link to "meta description" reference (#4566)
start_url: fix start_url audit while offline (#4710)
start-url: use window.location over fetch (#5159)
tsc: more type checking of top-level audits (#5089)
tsc: add type checking to dbw audits (#5069)
tsc: update for new @types/css-font-loading-module (#5061)
tsc: add type checking to Driver (#4827)
tsc: add type checking to gather-runner (#4944)
tsc: add type checking to asset-saver (#4949)
tsc: add types for DevtoolsLog and NetworkRecorder (#4918)
tsc: add type defs for Chrome Remote Debugging Protocol (#4816)
tsc: add type checking to remote protocol commands (#4914)
tsc: add type checking to fonts gatherer (#5018)
tsc: add type checking to use of CRDP events (#4886)
tsc: add type checking to dbw gatherers (#5005)
tsc: add type checking to most byte efficiency audits (#5072)
tsc: add type checking of first top-level audits (#5086)
tsc: fix OptimizedImages type; type check dep audits (#5129)
tsc: add type checking to seo gatherers (#4991)
tsc: add type checking to a11y and manual audits (#5055)
tsc: fix ImageUsage artifact type and gather bug (#5113)
tsc: add type checking to remaining top-level audits (#5090)
tsc: add type checking to computed artifacts (#5051)
tsc: add type checking to runner (#4961)
tsc: gather type-checking cleanup (#5019)
tsc: add type checking for seo audits (#5103)
add type checking to audit and gatherer base classes (#4762)
tsc: add type checking to many core gatherers (#4975)
convert diagnostics to numeric scores (#4778)
remove cache-start-url audit (#4760)
audit.details features numbers, not strings. introduce itemKey (#4384)
add default audit options for scores (#4927)
look up custom gatherer relative to the config file path (#4751)
add type checking to connection (#4738)
make url-shim extend native URL module; add type checking (#4712)
merge render blocking audits to lantern (#4995)
bump version to 3.0 alpha (#5082)
de-dupe URLs in is-on-http, uses-http2 (#4950)
rename uses-request-compression (#4763)
tti: update ignorable network requests and use FCP (#5021)
webapp-install: simplify start_url warning when no SW is found (#5067)

Deps

axe-core: update axe-core to 3.0.0-beta.2 release (#4595)
browserify: update deep transitive dep to use recent acorn (#4813)
browserify: bump browserify for async/await (#4767)
extension: bump browserify version and sub-deps (#5076)
robots-parser: patch robots-parser to work in browser env (#4819)
snyk: update snyk snapshot (#5074)
speedline: use speedline's types instead of our own (#5078)

Docs

contributing: fix link for closure annotations (#4680)
headless-chrome: switch to prioritize headless (#4553)
headless-chrome.md: fix broken link (#4523)
programmatic: add caveat about removing artifacts (#4540)
readme: remove ts command for lighthouse-cli dev (#5088)
readme: Bye Bye Greta (#5036)
releasing: updates (fcec593)
update docker image id (f092a8a)
remove dated domhtml reference from README (#4900)
"LHR" is "Lighthouse Result" (8861386)
add html report overview writeup (#5059)
report: minor fix of markdown link (#5063)
understanding-results: description can dynamically be the failureDescription (cc53688)

Extension

compilation: add object rest support (#4954)
tests: add extension pptr smoketest (#4640)
add checkbox for using Lantern/DevTools throttling (#5156)
pass flags through to config (#4936)
use browserify url library (#4875)
polish the status updates within the popup (#4780)
fix issue where gatheres cannot be found (#4592)

Report

bootup-time: fix learn more link (#4962)
score gauges, metrics display, add rich tooltips (#5009)
category: enable all categories to show audit groups, refactor CategoryRenderer (#4278)
final metrics display, icons, whitespace polish (#5130)
improved text-wrapping (#5138)
new audit list display, indexes & new icons (#5109)
error'd audits get 'Error!' treatment (#5077)
add docs link to bootup-time audit (#4537)
tweak tooltips (2993522)
add auditIds to DOM. update pptr tests to assert against them (#5058)
rework the DOM of audits (#5045)
only appendScoreScale to scoreHeader if it exists (#5040)
move html report from v2/ dir to html/ (#5034)
audit details not longer collapsible. fixup width and margin (#5151)
update link to rel=canonical reference (#4701)
implement new design for opportunities (#5115)
fix audit description typos (#4882)
update SEO audit descriptions & links (#4903)
add jsdoc for lhr.artifacts (#4859)
new header branding (#5125)
description: update helpText for document.title audit (#4677)
font-size, link-text: update docs links (#4829)
is-crawlable: fix broken learn more link (#4844)
scores: make sure scores are represented out of 100 (#4750)
seo: update link to the is-crawlable/indexing reference (#4678)
table: handle null cells (#5075)
util: fix formatDuration, add tests (#5023)

Tests

appeveyor: exclude perf smoketest until flake is fixed. (#5060)
exclude audit helpText from 'yarn diff:sample-json' assertion (#4964)
closure: avoid failing closure compilation (#4737)
closure: fix BSD sed calls within compile-devtools (#4736)
config: add merge-options test (#4747)
extension: add reminder about building the extension (#4902)
fixtures: introduce update-report-fixtures script (#4793)
smoke: add smoke test code coverage (#4967)
fix run-smoke handoff of testResults (#4959)
smokehouse: increase timeout (#4990)
smokehouse: split pwa2, perf batches (#4988)
smokehouse: adjust byte efficiency CPU multiplier (#4809)
smokehouse: retry failed tests (#5143)
smokehouse: run smoketests in parallel (#4748)
rename seo test files (#4853)
bump bundlesize threshold (#5050)
use nyc instead of istanbul for coverage (#4919)
node 10 compat (#5106)
disable compile-devtools on travis (48792ae)
add CI test to confirm sample_v2.json is up to date (#4956)
split up parallel smoketests into 2 batches (#4996)
drop port number from dbw_tester for golden lhr (#5006)
remove unused fixtures (#5107)
fix cli handling empty runnerResult during gatherMode (#5052)
viewer: add pptr test for viewer (#5025)

Misc

codeowners: revert brendan's leave (#4716)
eslint: add no-floating-decimal (leading zero) rule (#4893)
eslint: update to es2017 to allow async/await (#4791)
tsc: reorganize and expose external interfaces (#4788)
typecheck: add dependency graph to tsc (#4605)
remove timing from golden lhr (#5020)
clean *.screenshots.json (#4754)
drop support of Node 6 (#4703)
minor whitespace fix on unminified-css audit (16da670)

2.9.1 (2018-02-12)

Full Changelog

New Contributors!

Thanks to @GaryJones for helping us spel gud!

Core

REVERT: gather-runner: load a blank data URI, rather than about:blank (#4518)
fonts: fix infinite loop (#4488)
responsive-images: move images with no dimensions to offscreen audit (#4487)
tracing-processor: fix scheduleable task logic (#4480)
webfonts: patch fonts gatherer to handle missing font item (#4465)
computed-artifact: use deep equality over strict (#4409)

Docs & Tests

docs: examples of combining puppeteer & lighthouse (#4408)
appveyor: quietly unzip Chrome to keep appveyor logs cleaner (ecedb32)
appveyor: only run tests against master and PRs (#4484)
smokehouse: improve smokehouse failure output (#4482)
spelling: fix discernable to discernible (#4485)

2.9.0 (2018-02-08)

Full Changelog

New Contributors!

Thanks to @FadySamirSadek, @christhompson and @rupesh1 for their first contributions! Awesome stuff.

New Audits

mixed-content https upgradeability (#3953)
preload: Adding <link rel=preload> audit (#3450)
font-display: Recommend font-display: optional (#3831)

CLI

Add --extra-headers: Enable sending additional HTTP Headers (#3732)
Add --mixed-content: triggers the mixed content audit (#4441)

Core

centralize error strings (#4280)
gather-runner: load a branded data URI, rather than about:blank (#4310)
mobile-friendly: convey MFT covers add'l mobile-friendly auditing (#4307)
response-compression: Exclude binary files from auditing (#4144)
screenshot-thumbnails: increase size to 120px (#4383)
start-url: switch to plain old fetch (#4301)
unminified-js: add tolerant option to esprima (#4338)
a11y: aXe perf: only collect provided resultTypes (#4380)

Deps

bump metaviewport-parser to 0.2.0 (#4382)
snyk: update snyk snapshot (#4439)

Misc

coverage: minimize impact of timeout due to istanbul's instrumentation (#4396)
escape usage of '#' in data URIs (#4381)
package: scripts don't require "--" for options to be forwarded (#4437)
sentry: update sampled errors list (#4277)
travis: Only build on Node 6 for PRs. Don't do the push build for non-master. (af8dbd0)
Extension: Fix scrollbar from showing on Options page (#4263)

2.8.0 (2018-01-12)

Full Changelog

New Contributors!

Thanks to @jianzhoufeng and @nhodges for their first contributions!

New Audits

avoid plugins (#4218)
rel canonical: document has a valid rel=canonical (#4163)
unminified-css: identifies savings from unminified CSS (#4127)
unminified-javascript: detect savings from minifcation (#3950)
manual SEO audits (structured data & mobile friendly) (#4108)

Core

lifecycle: allow gathering & auditing to run separately (#3743)
gather-runner: covert assertPageLoaded into soft failure (#4048)
network-recorder: use findNetworkQuietPeriods for networkIdle (#4102)
report-generator: extract scoring into separate module (#4161)
screenshots: fix getParsedImage of null (#4189)
trace-of-tab: error when TracingStartedInPage is missing (#4164)
errors-in-console: If exception info is not present use exception text (#4191)
estimated-input-latency: remove target reference (#4069)
bootup-time: Add 10ms threshold to bootup-time audits (#4223)
font-size: make font size artifact serializable (#4194)

Report

a11y: Don't count non-applicable a11y audits toward score (#4052)
more attractive table/URL rendering (#4190)
improve devtools dark mode rendering (#4232)
categories: performance first, then pwa, then the others (#4095)
grammar: do not finalize audit titles with a period (c5f6d05)
change 'app' => 'web app' (29eecce)
Update vulnerability links (#4198)

Deps

bump js-library-detector (#4086)
chrome-launcher: Upgrade chrome-launcher to 0.10.2 (#4192)

Docs

readme: update CLI options, output examples. add GAR/Lifecycle examples (#4185)
readme: demo flags in example of programmatic use (#3841)
lantern: update accuracy data (#4180)
extract Release Guide into own docs file (#4200)
releasing: document the LH Release Process (#4201)
results: describe audit's notApplicable/error (#4186)

Extension

extract a new ext-bg file, splitting extn/devtools usecases (#4162)

Tests

remove global timeout, set timeouts individually (#4224)
trace-parser: use fs over require (#4209)
travis: force use of GCE, remove dSE calls (#4222)
travis: remove upload artifacts (#4219)
travis: test on Node 9, drop testing on Node 7 (#4181)

Misc

remove CLI's legacy domhtml output (#4176)
viewer: retain /plots/ when deploying new viewer version (#4079)

2.7.0 (2017-12-14)

Full Changelog

New Contributors!

Thanks to @sanjsanj, @dennismartensson, @daannijkamp, @crimeminister!

New Audits

accessibility: add accessibility manual audits (#3834)
font-size: legible font sizes audit (#3533)
hreflang: document has a valid hreflang code (#3815)

CLI

compile out remaining typescript; add tsc type checking via jsdocs (#3747)
sentry: handle configstore errors; don't enabling error reporting (#3878)

Core

config: show SEO audits in the UI (#4057)
critical-request-chains: corrected help text (#4009)
devtools-timeline-model: extract model generation to a computed artifact... (46f6d2a)
driver: add driver.wsEndpoint() (#3864)
gather-runner: fix headless chrome UA check (#4019)
noopener-audit: Only test http/https links (#4036)
optimized-images: skip mismatched mimeTypes (#4045)
seo: consistent help text links (#3901)
uses-webp: tweak text to be more next-gen focused (#3985)
vulnerable-libs: add fix for recovering from bad versions (#3932)
web-inspector: keep all experiments disabled, fixing conflict when running in DevTools (#4010)

Deps

Bump ws to 3.3.2 (#3949)

Docs

error-reporting: improve clarity for opt-out folks (#3876)
add lantern accuracy data (#3826)
fox mobile device testing example (#3887)
readme: Add Greta Lighthouse to list of Integrations (#4031)

Report

perf-audits: adjust presentation of runtime cost audits (#4020)
warnings: warn only if using an old headless (#4021)

Tests

smokehouse: adopt URLSearchParams for querystring manipulation (#3941)

Misc

changelog: tweaks to changelog template and instructions (#3849)
changelog: minor changelog generation usability bumps (#3847)
codeowners: represent brendan's leave (#3991)
error-reporting: report unhandled promise rejections, take 2 (#3930)
error-reporting: tweak sentry levels and ignore list (#3890)
error-reporting: report unhandled promise rejections (#3886)
Update wording (6036117)

2.6.0 (2017-11-18)

Full Changelog

New Contributors!

@peterjanes, @stevector, @AkshayIyer12, @manekinekko, @alekseykulikov, @coliff, @emazzotta

New Audits

redirects: avoid page redirects (#3308)
link-text: descriptive anchor text audit (#3490)
is-crawlable: page is blocked from indexing (#3657)
bootup-time: JS bootup time per script (#3563)
uses-long-cache-ttl: detects savings from leveraging caching (#3531)
mainthread-work-breakdown: audit for page-execution timings (#3520)

CLI

do not double quote chromeFlags (#3775)

Core

aspect-ratio: skip aspect ratio audit for svg (#3722)
audit: Ignore href=javascript:.* for rel=noopener audit (#3574)
bootup-time: refactor task/group iteration (33b1574)
config: add silent seo audits to default config (#3582)
config: re-weight a11y scores based on severity and frequency (#3515)
config: add category weight to perf config (#3529)
critical-request-chains: Remove iframe as Critical Request (#3583)
dependency-graph: add acyclic check (#3592)
devtools-model: fix missing Runtime.experiments object (#3514)
driver: increase default timeout to 45s (#3741)
driver: use execution context isolation when necessary (#3500)
emulation: remove use of deprecated Emulation.setVisibleSize (#3536)
errors-in-console: include runtime exceptions (#3494)
image-aspect-ratio: pass audit when no images are missized (#3552)
image-usage: add null check for parentElement (#3779)
add error reporting (CLI only) (#2420)
meta tag gatherers: meta tag search should be case-insensitive (#3729)
predictive-perf: predict FCP (#3730)
predictive-perf: refactor simulation logic (#3489)
response-compression: add transferSize sanity check (#3606)
record top-level warnings in LHR and display in report (#3692)
remove useless optimalValue (#3774)
speed-index: only compute perceptual speed index (#3845)
tags blocking first-paint: exclude script type=module (#3676)

Docs

changelog-generator: Generate changelogs (#3632)
scoring: create documentation on scoring (#3436)
bug-labels.md: Create bug-labels.md (#3522, #3525, #3535)
contributing: pr title guidelines (#3590)
correct capitalization of GitHub (#3669)
add results object explainer (#3495)
new-audits.md: Principles and guidance for new audits (#3617)
readme: add MagicLight WebBLE integration (#3613)
readme: add Treo to the list of integrations (#3484)
throttling: because comcast throttles the websocket (bedb9a1)

Report

Add print summary and print expanded options (#3578)
image-aspect-ratio: fix audit description (#3843)
redirects: reformat results, incl all requests and wasted time, (#3492)
render-blocking-stylesheets: improve actionability of helpText (#3544)

Tests

update eslint (and goog config) to latest (#3396)
eslint: use --quiet flag rather than --silent (#3491)
smokehouse: add long task to byte-efficiency tester to deflake appveyor (#3804)
smokehouse: disable multiple shadow root deprecation test (#3695)
smokehouse: Passive event listener violation doesn't report on passive:false now (#3498)
web-inspector: add test for setImmediate polyfill (#3670)

Misc

codereview: add CODEOWNERS file (#3591)
Bump chrome-launcher to 0.8.1 (#3479)
web-inspector: fall back to page's Runtime and queryParam() (#3497)
use undated Apache 2 LICENSE file (#3700)
audits: removed unused audit meta.category (#3554)
changelog: add commitlint config (for commitlintbot) (21e25aa)
commitizen: new-audit => new_audit (#3534)
jsconfig: Enable type checking for JavaScript (#3589)
logos: provide svg logo as png (8b3d7f0)
Fix minor grammatical error (#3638)
add cz-customizable to establish a commit message convention (#3499)
typo: fix typo in image-aspect-ratio audit (#3513)

2.5.1 (2017-10-06)

Full Changelog

Fix compat with DevTools via Runtime mock object

2.5.0 (2017-10-04)

Full Changelog

New Contributors!

Huge contributions from new contributors with all-new audits, Chrome launching improvements, and more complete documentation. Thanks to @mikecardwell, @rviscomi, @siddharthkp, @ThisIzKp, @rootulp, @kdzwinel, @LCartwright, @siteriaitaliana, @vinamratasingal, @alanyin0322, and @tkadlec!

New audits

image-aspect-ratio best practice audit (#3084)
time-to-first-byte perf audit (last fixes and now enabled) (#2231)
errors-in-console best practice audit (#2836)
no-vulnerable-libraries best practice audit (#2372)

New audits in full-config

unused-javascript coverage audit (#3085)

New audits in new SEO config (#2999)

meta-description SEO audit (#3227)
http-status-code SEO audit (#3311)

FastMode

add predictive-perf shell and base audit (#2720, #3189)
add network estimation (#3187, cf5638d6)
add CPU estimation (#3162, 18837dad, 5b459a1e)

Core

update unused-css-rules audit to support new coverage format (full-config only) (#2518)
perf: use Audits.getEncodedResponse in optimized-images audit (#3087)
don't wait for Page.navigate to resolve to listen for page load (#3413)
include v8.execute trace event category (ab6aabde)

Report

clarify wording of category descriptions (#3000)
add a linked-text type to details renderer (#3165)
fix: tame greedy markdown-link regex (#3312)
fix: prevent \u2028 and \u2029 from breaking the report (#3442)
improve descriptions for a11y audits (#3474)

Testing

smokehouse: adjust unused-css-rules audit expectations (#3036)
bundlesize: fix reporting in github UI (ede05c0a, #3392)
smokehouse: add basic smoke test for SEO audits (#3267)
travis: unset \_JAVA_OPTIONS for DevTools' compile_frontend.py test (#3354)
eslint: enable comma-dangle rule, fix all new errors (#3324)
smokehouse: add time-to-first-byte smoke test (#3310)

Docs

import audit glossary from SEO doc (#3207)
add advanced throttling guide (#3205)
readme: reduce minimum Chrome version to current stable (#3287, 5382f37c)
readme: add explanation for Lighthouse Integrations section (#3418) contributing.md: fix grammatical errors (#3419)

CLI

add blockedUrlPatterns support to CLI (#3125)
adopt yargsParser directly for chromeFlags parsing (#3408)

Chrome-launcher

chrome-launcher has moved to a standalone npm package

docs: add changelog (#2987)
improve SIGINT handling (#2959)
mute audio (#3028)
rev to 0.6.0 (ec38bcd9, 970d3cad, e9d569c5, 5e9a3aba)
handle errors inside spawnPromise (#2939)
switch to using standalone package (#3410)

Misc

apply small license header to remaining files (#3309)
fix: remove redundant lighthouse-logger/ from npm package (#3411)
remove old perfX code (#3431)
update plots-config to use newer quiet parameters (#3464)
collect even malformed error messages in extension (#3473)

Deps

upgrade bundlesize to 0.13.2 (#3122)
upgrade axe-core to 2.4.1 (#3284, #3320)
upgrade ws to 1.1.2 (2d2206b8)
add yargs-parser at 7.0.0 (#3477, #3478)

2.4.0 (2017-08-14)

Full Changelog

Core

Refactor error throwing from assertPageLoaded (#2785) (07817f9)
refactor: cleanup unused waitFor properties (#2716) (9d8a32f)
All audits must specify helpText and failureDescription (#2737) (db3f324)
"shrink-to-fit" property in "viewport" meta is no longer invalid (#2863) (e1a04dd)
driver: add compat comment on PerfObserver GC bug (d7ffec1)
emulation comment: can remove injectedTouchEventsFunction in October (#2889) (a6b71c9)
Ignoring other extension assets in request compression audit (#2733) (428f637)
fix(anchors-with-no-rel): ignore same origin links (#2749) (78ec647)
add flag to FMP to indicate if it fell back to FMP candidate (#2851) (46d9ba7)
fix(script-blocking-first-paint): ignore latent resources (#2721) (ac99084)
Include version and commit in lighthouse-background.js bundle (#2236) (7fe3574)

Report

link all a11y audits to 2.2 aXe docs (#2709) (924e1f1)
Update consistently-interactive.js helpText (#2740) (6f7bf29)
Update first-interactive.js helpText (#2739) (a829811)
Report: add lighthouse query param to axe helpText links (#2767) (4b9cbb5)
Report: Close export dropdown when printing (#2914) (a45ece8), closes #2914
report: draw metric lines over the screenshots. (#2848) (5832761)
fix(report): proper arrow state and consistent capitalization (#2750) (7c461bf)

Testing

testing: prune smokehouse configs to improve testing perf (#2732) (e72483b)

CLI

Fix: Basic chrome-flags parsing for embedded quotes (#2754) (78a8bd7)
Add hostname CLI flag and option for CriConnection (#2728) (0455283), closes GoogleChrome/lighthouse#2727

Chrome launcher

launcher: clarify priority of chromePath options (494f991)
chrome-launcher: add support for finding Chromium on Linux (#2950) (1c11021)
launcher: support enabling extension loading (#2650) (c942d17)
[chrome-launcher] Publish type definitions instead of source TypeScript files (#2898) (391e204)

Misc

Lowercase fix for "service worker" (#2729) (15068bd), closes #2729
open extension's report in new window. (fix for incognito) (#2734) (934aa42), closes #2734
pass --enable-extensions on from manual-chrome-launcher (#2735) (37fd38c)
Update lighthouse-logger location in readme (#2867) (1347b15)
readme: added CHROME_PATH description from CLI help (#2757) (af003d4)
readme: update example using deprecated LIGHTHOUSE_CHROMIUM_PATH (#2929) (de408ad)
docs: Add a changelog.md (#2986) (626ce68)
Viewer: log expected URL (#2724) (6478f15)
Fix eslint max length in github-api.js (#2730) (1ca40de), closes #2730
add license file to launcher package. (#2849) (8bc6d18)
Add license to lighthouse-logger. (#2846) (367ea7a)
Clarification of hasOfflineStartUrl rule (#2775) (7097d5c)
gulpfile. add commented out lines for sourcemap generation. (6f53ab9)

2.3.0 (2017-07-20)

Full Changelog

test: fix clang-format error (#2691) (fedc76a), closes #2691
test(format-helpers): TZ independent check (#2653) (56e8f9b)
add bundlesize to track our build size (#2676) (5172ff7)
Add failureDescription to audit. display on fail (#2478) (b0df777)
Added CHROME_PATH to readme (#2694) (5728695)
bump extension to 2.2.1 (e5f3a7b)
Expose LHR to modules consuming cli/run.ts (#2654) (9c0c078)
Fix chrome finder on linux/osx when process.env isn't populated (#2687) (112c2c7), closes #2687
fix launcher w/ arbitrary flags (#2670) (8c9724e), closes #2670
Gather-runner: Get useragent before emulating (#2715) (f8c1dc1)
launcher to 0.3.1 (2004363)
launcher to 0.3.2 (fc48c8a)
remove duplicate url check in core/index.js (#2658) (425b5fb)
track number of completed requests in total-byte-weight extendedInfo (#2697) (eecf525)
tweak codecov config. (e9d5a0f)
update "page load fast enough on 3G" helpText (1d0d4ff)
Update the helpText in uses-webp-images.js (#2681) (b93ca14)
update uses-optimized-images.js helpText (#2669) (5b41ebc)
update webapp-install-banner.js helpText (#2622) (a2e4e1e)
upgrade rimraf to latest (#2641) (ef08106)
v2.3.0 (232c99b)
perf(uses-http2): check protocol first (#2701) (bbe2191)
feat: add base fast mode config (#2702) (5d61056)
feat(computed-artifact): support arbitrarily many inputs (#2705) (4143aac)
refactor: extract computeLogNormalScore method (#2710) (648cce6)
refactor(StartUrl): switch from error to debugString object (#2549) (64b015e)
docs(config): add explanations for gatherers property (#2704) (76cdb54)
docs(readme): link to config docs from readme (98d85cc)
Report: improvements w/ new density... (#2706) (97c7170)
Report: Updated styles (#2297) (a9867d5)
fix(config): keep defaultPass on rebuild (#2671) (78e761a)
fix(domstats): enable DOM domain (#2640) (3ee5215)
fix(driver): prevent PerfObserver from being garbage collected (#2682) (36c2df5)
launcher: log the specific chrome spawn command. (3f143b1)
launcher: nuke 'as string' (a6bbcab)
launcher: support custom port via chrome-debug binary (#2644) (6df6b0e)
cli: remove --select-chrome,--skip-autolaunch. Support CHROME_PATH env (#2659) (41df647)
connection: log the protocol error data field (#2645) (d587357)
plots: dashboard - identify variance over lighthouse versions (#2520) (9561330)

2.2.1 (2017-06-30)

v2.2.1 (187c6d5)
fix(extension): Restore status logging to extension (#2629) (fe99052)

2.2.0 (2017-06-30)

Full Changelog

`chrome-launcher` shipped as a standalone module

The chrome-launcher module is now on npm. Great for working with Chrome headless.

Lighthouse viewer updated for Lighthouse 2.0

The Lighthouse Report Viewer can now view data from Lighthouse 2.x, including JSON saved from the CLI, exported from the Chrome extension or DevTools Audits panel. (#2521)

New contributors

Thanks to Katie Hempenius, Artur M, Kevin Farrugia, Piper Chester, Robin Drexler, and Mike Deverell. Due to the effort of these developers we now have an audit for checking for paste-blocked password fields, unified usage of toLocaleString(), a correct gulp recipe, a well-functioning chrome-launcher module, and improved clarity in the audit test descriptions. We truly appreciate all these improvements!

Since 2.1.0 we've had a number of other features, fixes, and improvements. Presented by category:

Report

use locale string for all our number output (#2553)
fixes viewer CSS specificity and event listener removal (#2575)
freshen up audit helpText
Report: don't display score gauge header if there's only one. (#2261)
Remove report v1 and dependencies (#2596)
better debug message for missing network times (#2451)
spelling fix in link-name audit (#2496)
Theme Color wording fixes (#2466)

Audit + Gather

fix(driver): wait for CPU idle via clientside perfObserver (#2473)
Remove /deep/ usage as it is being deprecated (#2371)
Remove BOM encoding from manifest (#2175)
Throw better error message when url is not auditable (#2527)
Critical Request Chain audit: fix incorrect transfersize. (#2610)
domstats: prevent infinite loop (#2561)

Performance & Traces

docs: add trace interpretation guide (#2472)
use a stable sort for trace events (#2415)
remove old TTI code (#2452)
refactor(trace-of-tab): return timestamps in microseconds (#2454)
add streaming json parser
add streaming trace writer in saveAssets

Plots

better support power use cases (#2464)
disable flaky smoke test (#2606)
smoke test for happy case (#2411)

Configurability

feat(config): add audit blacklist support (#2499)
feat(config): add extends lighthouse:full (#2557)
docs(config): add config documentation (#2592)

Misc

Add script to capture travis build durations (#2541)
Expose launch/lighthouse/report flow to consuming modules (#2602)
harden security of static-server (#2563)
is-on-https: check record.protocol for blob urls (#2538)
LH implementation of LogNormalDistribution; remove traceviewer (#2456)
move computed artifacts dependent on networkRecords to devtoolsLog (#2467)
Enable typescript coverage metrics for coveralls.

2.1.0 (2017-06-07)

Full Changelog

Fixed bugs:

Friendlier message for multiple tabs to same origin #2299
de-jsonify default.js #2445
Compact the license headers #2444
update smokehouse PWA expectations #2443
Disable the dismissJavaScriptDialogs smoketest. #2437
Large DOM size increases memory usage, not memory (fix wording) #2433 (khempenius)
Fix US-centric wording #2432 (khempenius)
add units to LoadFastEnough debug string #2427
remove aggregations #2426
link to "offscreen images" reference #2417 (kaycebasques)
readme: add notes on per runs #2410
Updated readme to add port number when testing a site with authentication #2409 (mikerhyssmith)
Update optimized-images overview jsdoc #2408
fix(report): footer height on small viewports #2400
rmtraceviewer branch: reduce -> for..of #2399
feat: tooltips for all formatted URLs #2398
travis: include node 8.0.0 #2395
fixed incorrect comments #2392 (mixed)
Appveyor fixes: fresh yarn, only node6 build #2382
Run npm install/build tasks in parallel #2381
Re-enable AppVeyor support. #2380 (XhmikosR)
Fix icons on firefox by decoding svg imgs #2378 (ev1stensberg)
revise package.json script to the correct folder #2373 (ev1stensberg)
update help text for a11y audits #2370 (kaycebasques)
fix: deprecate old HTML report #2367
add audit to check if paste is allowed in password inputs #2366 (robin-drexler)
swap math.round with util.formatNumber #2361 (ev1stensberg)
😈 Fix disconnect promise race. #2359 (samccone)
Enable passing of a custom userDataDir to launcher #2357 (samccone)
test(smokehouse): add numeric comparisons #2356
✨ Add Calibre and WPT to Readme #2355 (benschwarz)
fix: bump jpeg quality #2354
fix: hide violations with no URL information #2352
fix(connection): gracefully handle missing method #2351
fix: normalize all times to navStart, remove traceviewer model #2347
extension: Fix formatting of bug reports #2343
Docs: update readme, add docs/readme, modernize a bit #2341
Total byte audit reports full URL #2312 (johnboxall)
polish: show audits with debug string, don't fail loadfast4pwa on network latencies, works-offline change #2294
fix: always ensure tracing is off before starting #2279
polish: listen for network idle after DCL #2271
Switch to containerized Trusty #2234 (stramel)
Plots: make measure script more flexible (CLI args) #2183 (wwwillchen)

2.0.0 (2017-05-19)

Full Changelog

Big changes

Brand new report

Everything is brand new UI. header footer, left nav, export, score gauges… screenshots! filmstrip . pass and failures seperated. Sparklines. Accessibility by section. Perf sections..

Chrome DevTools Integration

Take a look at the DevTools' Audit tab, where Lighthouse is now integrated

Lighthouse is much faster now

Overall the Operation Yaquina Bay (Issue #2146) effort made massive improvements to the total lighthouse runtime:

476e7806 fix: remove afterPass throttling (#1901)
7d7bac66 perf: enable speedline fastMode (#2230)
f7ea9354 perf(config): disable styles gatherer (#2153)
d99778b4 perf: consolidate DBW pass into defaultPass (#2160)
ff21a33a fix: only record a trace if needed by an audit (#2117)
740c2e99 perf(gather-runner): Clear cache selectively per-pass (#2156)
4c515cfa block stylesheets and images on redirect pass (#2168)
d0cb646a perf(gatherers): skip optimization of cross origin images (#2154)
d99b5ada perf: make network quiet threshold configurable per pass (#2220)

New Contributors!

Huge thanks to who contributed 27 epic PRs.

@abacon - remove images from critical request chains
@benschwarz - Calibre and WPT to readme
@chrisdwheatley - add related projects section
@dandv - Mention where the documentation is
@dgozman - Add basic rendering to report generator v2
@ev1stensberg - math.round scores, firefox svg images, package.json correct folder
@jinjorge - Fix typo in readme
@jimthedev - readme instructions for running behind a login
@johnboxall - Total byte audit reports full URL
@mrbusche - Update outdated link for "Web App Install Banners" article
@maya - Fix "Installation" spelling mistake
@stramel - non-critical images, template literal linting, containerized trusty
@mikerhyssmith - Updated readme to add port number when testing a site with authentication
@sendilkumarn - handlebars precompiled (we'll pour one out), clearer iconography, helpText fixes.
@ZZhaoTireless - report <details> printing fix
@cedricbellet - handleJavascriptDialogs
@thearegee - Readme: Adding lighthouse-cron to Related Projects

Audits

Added the "is fast on 3g" audit
4c34e28f Fix service worker gatherer by waiting for active state (#1864)
bbe7f3b9 allow computed artifacts to request other computed artifacts (#2018)
ba01e2a2 Added audit for request compression (gzip & br) (#1513)
ef520256 feat(image-usage): add support for CSS images (#1868)
17088655 fix: default(.json -> .js). Disable css usage audit (#1911)
50349613 Collapse the 9 manifest PWA audits into 3 (#1847)
902585b8 feat: add OffscreenImages Audit (#1807)
bad5bdae Add TTI < 10s audit for PWA (#1840)
d2cb5a21 feat: add consistently interactive audit (#2023)
d3a06925 DOMStat Audit: shadow roots don't have .classList (#2131)
691157f2 Add audit to check if start_url is cached by SW (#2040)
df2fae5e PWA Audits: add placeholders for rest of baseline checks. (#2248)
3c752a0c refactor: split optimized images into WebP and optimize audit (#2216)
c908e817 retire TTI (alpha) audit (#2266)

Metrics & Precision

ade2d88f Enable CPU throttling (4.5x) (#1778)
added the TTFI and TTCI metrics
f1aeb581 Fix screenshot capture bounds (#1839)
7b86c71e Enhance error wording around busy traces. (#2247)
008c5d91 add lighthouse execution time to json results (#2241)
f0e0dfaf tests: exclude score checking and flaky link preload assertion. (#2202)
bd7f862d Update: Use array of non-critical resource types (#2191)
0549cca7 fix: always use navStart as speedline timeOrigin (#2114)
da8e0979 NEW feat: add firstInteractive (#2013)
2212ca2e Update network throttling to simulate more realistic network conditions (#2238)
b5bf067b Remove images from critical request chains. (#2085)
0bf1744b fix: add more helpful error messages when fMP is missing (#1959)
ca2600ac Improve reliability of finding navStart (#1895)
04579fe3 Ignore cache hits for "fast on 3g" check (#2143)
b1784d12 Ignore memory cache hits too. ref #2143
e84530e7 fix: bump jpeg quality for image optimization audit (#2354)
0d0e93f3 fix: do not flag blob urls as insecure (#2330)
782acc59 polish: do not fail loadfast4pwa for internal redirects (#2296)

Plots

b2eaa086 Plots: A/B screenshot viewer (#2026)
618d5f0a plots: metrics-per-site view (#2041)
c43eb098 plots: measure and visualize perf metrics (#1936)
3f7e5a1c Plots: make measure script more flexible (CLI args) (#2183)

CLI

Chrome launcher is a thing now.
2bb9c5b3 readme: tell developer to have yarn installed. ref #2072
65bec1bd feat(cli): add support for custom trace categories (#1866)
b9bce62b Warn users if they have not yet generated the file. (#2176)

Testing

47ee1b8d travis: include node 8.0.0 (#2395)
Re-enable AppVeyor support #2380, #2382
d5854b64 test(smokehouse): add numeric comparisons (#2356)
8b47006e Smokehouse: log out the node command we spawn (#2074)
4f598c50 ci: save perf trace to S3 on failure (#2051)
5945332c Switch to containerized Trusty (#2234)
fb791e40 update eslint curly rule to google js style (#2263)

Misc

07e0aab1 Remove recordNetwork from config (#2102)
16b0b048 feat: support Config category and audit whitelisting (#1988)
b2ccdfcb Allow opn & update-notifier CLI deps to be optional. (#2150)
283af871 dismiss any Javascript Dialogs automatically (#1939) (#2106)
e475bdb5 refactor(aggregations): switch usage of aggregations to categories (#1935)
48b72a85 fix: always ensure tracing is off before starting (#2279)
131df278 polish: listen for network idle after DCL (#2271)
d7e4d1bb always construct networkRecords from devtoolsLog (#2133)
11a1db3c networkRecords => computed artifact. generate networkRecords during gather via the networkRecorder dispatcher breaking change: performanceLog => devtoolsLogs
fb3cfbd5 makes non-finished network records available (#2197)
d7064290 extension: Fix formatting of bug reports (#2343)
9f5a8aa9 Add error to chrome extension when url is using the chrome protocol (#2346)

Docs

Many readme/contributing changes, related projects
e46f5401 Architecture docs: add arch diagram and lingo updates (#2158)
af479e9f Architecture diagram
8047ef36 Add custom audit recipe (#2255)
6898d09e add CI gulp recipe (#1886)
909a4638 add doc for testing site with authentication (#1906)
7c1c1c59 improve instructions for running behind a login (#2123)
fb86d507 Docs: add docs/readme (#2341)
d926f321 README: update CLI help with latest. Give common examples (#2182)
15c5ef13 add related projects section (#1835)

Deps

e46244d6 Bump axe-core (#2090)
638760ee Migrate all dev scripts + docs from npm to yarn. (#2071, #2072, #2067)
d90bce3b fix: bump speedline to fix perceptual speed index (#2046)
3716658b Rev axe to address #2206 (#2335)

1.6.5 (2017-03-04)

Full Changelog

This is a maintenance release on the stable 1.6 branch.

Master branch (tagged at 2.0.0-alpha) is under some heavy refactors, so we're holding off on shipping a new version. Expect one by mid-May. ( Poke around recent PRs and issues if you're curious what we're up to ;)

In the meantime, only a few changes here in 1.6.5:

Audits

Improve HTTPS audit by using network records rather than Security domain, which is broken on Android.(original pr #1918) (#2054)
Disable unused css rules audit for now, as we want to revisit correctness later (#1912)

Report

Add legend to decipher iconography left to us by the ancient ones (#1841)
Print doesn't cut off expanded audit details (#1870)
Biggin icons for a11y (#1856)
Tweak report colors so that we are WCAG2AA valid.

CLI

support multiple output modes (#1813)
add update-notifier. (#1890)

Testing

smokehouse: fix flakiness of dom-size expectation (#1881)
include a normal CLI run in the travis build.

Misc

remove npm prepublish (#1889)

Thanks to @ebidel and @paulirish for merging this stuff back to stable branch.

1.6.0 (2017-03-04)

Full Changelog

There were 44 PRs landed for this release. These are their stories.

New Contributors!

Huge thanks to @sendilkumarn, who contributed four epic PRs. Also welcome to @tommycli, @narendrashetty, @mohsen1 and @dentemple. Readme tweaks are how it all starts. ;)

Notable Changes

WebPageTest integration is in beta

By popular demand, you will soon have a way to run Lighthouse on demand in the cloud. We've worked closely with WebPageTest to enable Lighthouse auditing and analysis from within a WPT run. Our contribution WPO-Foundation/webpagetest#825 was just merged and Lighthouse on WPT is currently in private beta.

Lighthouse's CLI output has taken a chill pill - #1764

While you can view all Lighthouse results on the command line, it hasn't scaled well. A few screenworths of report was generally dumped to stdout right as Lighthouse finished up. Now, to keep your terminal happy, you will no longer see the reams of results printed to stdout. The HTML report is saved to disk by default, and you can automatically open it with lighthouse --view.

If you still want the stdout output, use --output=pretty. Oh so pretty.

CI coverage for Windows via AppVeyor - #1280

Thanks to a large effort from @XhmikosR, we now have an eye in the sky on Lighthouse's Windows compatibility. Now, all PRs are tested on both Linux and Windows.

New audits

New audit: DOM stats (total nodes, depth, width). (#1673) Get flagged if the size or depth of your DOM is big enough to cause big slowdowns.
New audit: Total byte weight audit (#1759). An extra check to make sure folks don't ship 5MB webpages.

Improvements

CLI: Add --chrome-flags option to CLI. (#1761)
CLI: Add --disable-storage-reset flag to skip clearing cache and storage (#1675)
Report: Centralize perf audits within Performance section (#1724)
Report: Collapse sections when all audits pass (#1742)
Config: Allow extension of default config (#1731)
Config: Configurable blank page options (#1732)
Config: Configurable page timeout (#1672)
Disable throttling for non-performance passes (#1740)
Reduce build size by 33% (#1756)
Enhanced display URLs (#1793)

Bug Fixes

Improve reliability of TTI metric by extending trace (#1785)
Do not fail if chrome could not be killed (#1735)
Headless fix: reuse existing tab if creating new tab fails (#1760)
Fix code escaping (#1790)
Speculative fix for getCurrentTabURL (#1753)
Rewrite chrome:// URLs to compare them. (#1777)
Responsive image audit correctly handles SVG and duplicates (#1749)

Testing

Use download-chrome.sh to download Chrome on Windows too.
Add AppVeyor CI support for Windows testing.

Docs

Link to PWA Checklist (#1734)
Reorganization and new "Using programmatically" section (#1721)
fix typo in promise chain
minor yarn typo fix (#1736)
Fix typo s/console.err/console.error (#1772)

Refactor

DRY byte efficiency audits (#1635)
Add explicit strict null checks for TS. (#1763)
CSS consistency changes. (#1698)
Switch to two space indention. (#1693)
Refactor handlebar helpers into static methods

Report Improvements

Use ! for aggregation icon when some audits dont pass (#1789)
Clearer iconography in Perf metrics and Fancier Stuff (#1750)
Adopt the non-failure iconography for perf audits (#1812)
Reformat the critical chain details (#1647)
Reformat the usertiming details (#1810)
Adjust table em color val for WCAG2AA. (#1743)
Better colors. Still accessible (#1758)
Brand the header (#1797)
Quazzle the tardiplums for best quality fleekdrops.

Report Bug fixes

Fix table overflow with Firefox. (#1704)
Use pre instead of inline code for listener snippets. (#1786)
Use the same favicon as the viewer. (#1657)
Tweak colors so that we are WCAG2AA valid. (#1686)
CSS icon alignment for FF (#1796)
Clean up table styling (#1726)

1.5.1 (2017-02-10)

Full changelog (2017-02-10)

Bug Fixes

HTML hygiene - #1682, #1683, #1684
Extension: Rollback of management permission to study effect first (#1689) - #1687

1.5.0 (2017-02-10)

Full Changelog

There were 128 PRs landed for this release. These are their stories.

New Contributors!

@graph1994, @denar90, and @kiermasp

Notable Changes

Dropped support for Node earlier than v6 - #1519

Node v6 became the Node long-term-support version in October 2016. After a suitable mourning period for v4 with a --harmony flag, Lighthouse has moved on and will only support v6+ going forward.
Improved selection of First Contentful and Meaningful Paint events from unusual traces - #1632, #1634

Lighthouse has banished the dreaded -1 score that has long plagued runs for certain sites.

First Meaningful Paint is now detected much more robustly. While it is not yet a completely solved problem, a large class of these errors should be eliminated. Reporting on these errors has also improved over the ambiguous -1, clearly differentiating between an issue with Lighthouse and an issue with the page being tested.
Open local report in online report Viewer - #1179

When viewing a Lighthouse HTML report generated locally—in the extension or from the command line—a new option is available in the "Export..." dropdown that allows you to upload to the Lighthouse Online Viewer.

You can then use the Viewer share button to get a report URL that you can share freely.

Behind the scenes, Viewer gets your permission via OAuth to create a GitHub secret gist and saves the report there. Since it's done as your gist, you maintain full control over the sharing of the report and you can delete it at any time. You can revoke the Viewer's permission to create gists under your GitHub settings.
Performance metrics are injected into trace saved with --save-assets for viewing in timeline - #1446

Lighthouse metrics like "First meaningful paint", "Time to Interactive", etc are mocked out as User Timing measures and injected back into the trace taken by Lighthouse.

If you save a run's trace with --save-assets and then open it in DevTools or Timeline Viewer, you'll be able to see your key metrics in context with the full trace of the page load.
Throttling and emulation information in report - #1485, #1608, fc858ea

It's easy to forget what throttling and emulation settings were used for a particular Lighthouse run after some time has passed. The settings used are now saved in the raw JSON results and are printed at the top of the HTML report under the arrow dropdown.
UI to interactively block certain page resources and measure the load performance difference

The first version of the Performance Experiment project is landing in 1.5.0. When Lighthouse is run with the --interactive flag, a special report is generated that allows interactive selection of costly page resources. The experiment server then reruns Lighthouse on that page with those resources blocked.

This lets you experiment with your page load performance, interactively testing the effects of blocking or delaying assets in your critical path.

New Audits

CSS usage - #1421, #1479, #1466, #1496, #1557

Reports the number of unused style rules in your page and the byte/time savings of removing them:
Image optimization - #1452, #1579

Reports images that are unoptimized and the byte/time savings of optimizing them:
Report Chrome's deprecated API warnings - #1470

Lists console warnings from Chrome if your page is using deprecated APIs or features that have interventions:
Responsive image sizing - #1497

Reports images that are too big and the potential byte/time savings of sizing them correctly for the given device:

Improvements

Audit: Catch more obsolete cases in no-old-flexbox audit - #1374
Audit: Add extended timing data to speed-index audit results - #1430, #1558
Audit: Base bytes- and time-saved estimates on mean throughput for that load - #1536
CLI: Disable more Chrome background features that may interfere with auditing - #1416
CLI: Close tab when Lighthouse is done with it - #1543, #1592
CLI: Use --output-path when saving artifacts and assets from run - #1601
CLI: Update --perf config to include latest perf audits - #1640
Extension: Move from a persistent background page to an event page - #1487
Extension: ~~Option to disable other extensions during run for improved accuracy~~ - #1492, #1604 (see #1689)
Gatherer: Issue all-event-listeners collection commands in parallel to improve performance - #1667
PerformanceExperiment: Create server to rerun Lighthouse with new options on POST request - #1393
PerformanceExperiment: Add UI for options to block asset loading on rerun - #1455, #1577
PerformanceExperiment: Add report sidebar to switch between multiple Lighthouse run results - #1477, #1597
Report: Expand audit <details> on print - #1468
Report: Add table formatter for audit details - #1505, #1538, #1546, #1547, #1545, #1622, #1636, #1678
Report: Reduce visual noise by auto-collapsing audit details and removing redundant info - #1561, #1598, #1606, #1617
Report: Remove 'Coming Soon' results from report - #1637
Report: Share save and export code in report and Viewer - #1594
Viewer: Make Viewer a PWA - #1554, #1571

Bug Fixes

Stop Lighthouse run if initial page request fails (404, domain not found, etc) - #1174, #1603, #1677
Audit: Check for proper mimetype in tags-that-block audit - #1432
Audit: Add proper parsing of meta viewport content - #1267
Audit: Ignore fragment in document URL comparison to correctly test offline loading - #1319, #1566
Audit: Filter out goog_* from user timings - #1563
Audit: Report proper first paint delay for blocking tags audits - #1555
Audit: Handle empty chain in critical-request-chains audit - #1620
Audit: Warn that geolocation-on-start gatherer cannot be run on insecure origins - #1679
CLI: Guard against launching multiple Chrome processes - #1436
CLI: Add support to find Chrome via LIGHTHOUSE_CHROMIUM_PATH variable on Windows - #1572
PerformanceExperiment: Fix various cross-browser report issues - #1593
Report: Improve filename eliding in audit details - #1437
Report: Various fixes for mobile and cross-browser issues - #1429, #1551, #1590, #1626
Report: Change generated HTML to be mostly valid; improve CSS consistency - #1575, #1627

Testing

Viewer: Add tests for file uploader - #1184
Update smokehouse to support deep comparisons of test expectations - #1450, #1457
Fix eslint base config, improve rules - #1462, #1440
Deal with Shop test site flakiness - #1491, #1493, #1654
Remove global installation of typescript on Travis - #1520
Use bash and node explicitly in npm scripts for cross-platform compatibility - #1510
Switch to a more concise unit test reporter - #1650

Docs

Add Chrome webstore extension screenshots - #1481, #1531, #1526
Various JSDoc, markdown, and capitalization fixes - #1441, #1494, #1503, #1533, #1523, #1553, #1565
Audit: Change messaging for uses-h2 audit - #1445
Report: Add help text (with links to docs) to manifest and a11y audits - #1428, #1589

Refactor

Use json-stringify-safe only when necessary - #1435
Centralize console special characters for cross-platform compatibility - #1438, #1509
Add JS information to categories traced - #1442, #1444
Track enabled debugger domains for safe simultaneous use - #1474
Node v6+: switch to rest parameters, [].includes(), and default parameters - #1524, #1580, #1633
Introduce TraceOfTab computed artifact to centralize extraction of key trace events - #1549
Handle gatherer errors as native exceptions instead of -1 ad hoc system - #1560, #1623, #1641, #1624
Create audit error result to rid report of -1s and score more consistently - #1591, #1649, f92b8ed
Save log of debugger protocol messages for Page and Network events - #1665, #1669
Move tracingModel to computed artifact to halve time spent constructing timeline model - #1668
CLI: Simplification of asset saving format and filenames - #1433, bba5818
Report: Turn report script into class, Viewer into subclass - #1471, #1559
Report: Include each partial's CSS only once - #1652

Release

Add release checklist to contribution guide - #1409, #1423
Add npmignore file - #1411, #1681
Add install/build scripts for each package.json - #1439, #1488, #1522

Dependencies

Lock package.json dependencies to specific versions - #1422
Update mocha to 3.2.0 - #1585

1.4.1 (2017-01-05)

1.4.1 (#1406) (179783b)
Add LH images assets. Fixes #1401 (0d5a4bc), closes #1401
Allow FMP trace event to appear slightly before the FCP (#1404) (a7648e7)
fix: don't extend URL in url-shim to support es5 transpilation (#1407) (b03b0db)

1.4.0 (2017-01-04)

Full changelog

New Contributors!

@dracos, @lokson, and @AdrianoCahete

Improvements

Add URL blocking by pattern to driver - #1195
Extension: Add test URL to "Report Error" template - #1357
Extension: Keep Lighthouse extension popup active while running - #1185
Extension: Use live icon and badge text while running - #1367
Gather: Only run axe tests that we have audits for - #1257
Report: Only use markdown for injected HTML - #1226
Report: Style tweaks for DevTools report - 4a2f97a21644989c325e1203be2af7230773934f, 68ccb6401143f18ac9702bb8d05a82936c1c8b0e
Report: Include total score in JSON and pretty output modes - #1356
Viewer: Add input for gist URL on mobile - #1341

Bug Fixes

Audit: Handle invalid URLs in external-anchors-use-rel-noopener audit - #1358
Audit: Handle invalid URLs in no-console-time and no-datenow audits - #1288
Audit: Make zero-length critical-request chains pass the test - #1303
Audit: Add "minimal-ui" as an allowed Manifest display value - #1268
Audit: Improved handling of invalid URLs in call site and event listener audits - #1390
Audit: Async stylesheet handling to limit false positives for stylesheets blocking first paint - #1389
CLI: Improve Windows console support - #1307
CLI: Ignore which failures when looking for Linux Chrome executable - #1395

Docs

Closure type check fixes - #1293

Refactor

Return artifacts from Runner (and move assets/artifacts saving to CLI) - #1163, #1400
PerformanceExperiment: Centralize more implementation in server.js - #1189

Dependencies

Only list mkdirp dependency once - #1284
Add marked - #1226

1.3.2 (2016-12-23)

1.3.2 (#1281) (aa1059b)
handle Date.now uses with call site URL (#1277) (2299f94)

1.3.1 (2016-12-22)

New Contributor!

@XhmikosR

Improvements

Report: remove noreferrer from helpText links (#1190)
Viewer: add consolidated export button - #1182

Bug Fixes

Remove Node v7 URL parsing while bugs are being fixed - #1187
Fix driver.captureFunctionCallSites in the face of Error polyfills - #1218
Audit: handle anchor tags with no href in 'external-anchors-use-rel-noopener' audit - #1238
CLI: use exec, not spawn, to kill Chrome process on Windows - #1206
Viewer: don't check upload's file type, try to parse json file directly - #1234

Docs

readme: improve definition - #1216

1.3.0 (2016-12-20)

full changelog

New Contributors!

@Janpot, @robdodson, and @WeiweiAtGit

Major Changes

New hosted Lighthouse report viewer - #1109, #1139
New Lighthouse logo - #1129, #1144

Improvements

Use whatwg-url to parse URLs - #997
Use firstMeaningfulPaint trace event directly - #1066
Remove whitespace and comments from traceviewer-js - #1095, #1103
Audit: Remove browser-generated paintNonDefaultBackgroundColor event from user-timings - #1077
Audit: Handle where tracingStartedInPage doesn't precede navStart in trace - #1152, 9c8d13e5
Audit: Add new required attr and attr-value accessibility audits - #1156
CLI: Add improved search for Chrome executable on Linux - #856
CLI: Add check that TypeScript files have been compiled before running - #1113
CLI: Add --view flag which serves generated report after Lighthouse run - #1130, f6afd225
Driver: Return meaningful errors from page context when evaluateAsync rejects - #1037
Report: Create "Fancier Stuff" section for newer (but not necessarily better) APIs - #1087
Report: Convert helpText toggle to pure CSS - #1104
Report: Stick header to top of page - #1121, #1132, #1133
Report: Make mobile-friendly and responsive - #1134
Report: Don't emit script tags in devtools report - #1105
Report: Use same favicon throughout all reports - #1172
Viewer: Move share button to core report - #1117
Viewer: Add support for copy and paste of report JSON - #1126, #1128
Viewer: Concat CSS files - #1153

Bug Fixes

Unmute some smoke test failures - #1081
CLI: Make rimraf async for deleting Chrome temp profile - #1127
CLI: Eliminate errors from calling ChromeLauncher.kill() twice - #1131
CLI: Fix html reportContext when generated by the CLI - #1171
Driver: Fix evaluateAsync when page has overridden native Promise - #1037, #1178
Report: Fix for formatting with unknown time zone - #1086
Report: Fix report color issues in Safari - #1114
Report: Fix print styling - #1180
Testing: Handle critical-request-chains audit promise rejections - #1100
Testing: Fix failing lint test - aa6d38b3
Viewer: Disable sharing button if gist is already saved - #1118

Testing

Don't run Closure type checking on Travis - 558a26
Update eslint and eslint-config-google to latest - #1136, #1159, #1160
Audit: Add tests for notification-on-start - #1089
CLI: Add test for obsolete CLI flags - #1168
Viewer: Add analytics #1120, #1162
Viewer: Add build of viewer to CI test suite - #1160

Docs

Update jsconfig for intellisense - 835ae985
Audit: Fix type in no-console-time helpText - #1142
Audit: Add links to DoBetterWeb helpText docs - #1161
readme: Add Viewer to readme - #1164

Refactor

Audit: Add check for an audit's requiredArtifacts before running - #1088
Audit: Centralize auditing of axe-core results - #1167
CLI: Unify bin.ts execution and error-handling paths - #1141
Gatherer: Gatherers now return artifacts directly rather than setting this.artifact - #1122
Viewer: Split code into modules - #1116
Viewer: Use tsc to es3ify viewer code - #1150

Dependencies

Add whatwg-url - #997
Add opn - #1130
Remove jszip - #1094
Update eslint and eslint-config-google - #1136
Update axe-core to 2.1.7; now 8x faster - #1155

1.2.2 (2016-11-29)

full changelog

New Contributor!

@beaufortfrancois

Improvements

Extension: remove "tabs" extension permission - #1032

Bug Fixes

Ensure driver.captureFunctionCallSites resolves to an array - #1036
Handle call sites in eval'd code in driver.captureFunctionCallSites - #1073
Audit: identify noopener when in list of link types in rel - #1035
CLI: explicitly close outfile and errfile in chrome launcher - #1057
Extension: set minimum supported Chrome to m54 - #1027
Extension: better error message if user attempts to audit the Chrome Web Store - #1025
Report: work around unsupported timezones when pretty printing dates - #1067
Report: fix coloring by score - #1070

Docs

Report: better formatting for Manifest icon size list - #1041, #1044
Report: improve language consistency in audit description strings - #1045
Report: add helpText to remaining audits - #998
Report: remove scores from performance metrics; change to pass/fail - #1072

1.2.1 (2016-11-23)

full changelog

Improvements

Audit: add DBW audit for <script> elements in head that block first paint - #965
Extension: Add error description to title of auto-generated github issues - #992

Bug Fixes

fix typo in default config file - f9f7c25
Audit: treat non-strings as an error in without-javascript gatherer and audit - #971
Audit: catch driver errors (and set on artifact.debugString) in geolocation gatherer - #999
Audit: fix property name used for error value in all-event-listeners gatherer - #1013
CLI: fix implicit-any-typed _ in chrome launcher - #981
Extension: fix aggregation category filtering based on selection in options panel - #973
Report: escape </script> tags when embedding raw results in the html page - #1003

Testing

Force npm install (for now) on Travis after their change to prefer yarn - #994

Docs

readme: new report screenshot - cb2ebfd

Refactor

Unify CLI and extension implementations of debugger protocol error handling - #977

1.2.0 (2016-11-17)

full changelog

New Contributors!

@Bassoon08, @karanjthakkar, @chowse, @hsingh23, @olingern, and @patrickhulce

Major Changes

Launch DoBetterWeb (DBW) audits and gatherers as part of default Lighthouse run - #917
Report: Lighthouse report refactor and refresh - #926, #935

Improvements

Log errors in red, warnings in yellow - #860, #915
Audit: Add DBW audit for Mutation Events - #786
Audit: Add DBW audit for <link> elements in head that block first paint - #892
Audit: Add DBW audit for rel=noopener on external links - #912
Audit: Make geolocation audit return error if permission already granted - #925
CLI: Handle --quiet logging as silent - #881
Extension: Add integrated 'Report Error' button with pre-populated data - #944
Gatherer: Add support for collecting event listeners across all DOM nodes - #930
Report: Remove excessive EIL percentiles from report - #851
Report: Update TTI scoring label to 5000ms to match guidance - #947
Report: Cleanup of event listener extended info display - #952
Report: Group event listener extended info by call site location - #960

Bug Fixes

Restore log's status event payload - #883
Ignore protocol error from defensive DOM.disable call - #895, #907
Remove cache-contents gatherer from default config since currently no audit requires it - #900
Enforce audit naming consistency in the config file and filenames - #914
Audit: Handle error case from htmlwithoutjs gatherer and audit - #891
Audit: Prevent attempts to parse script URLs when no URL was found - #893
Audit: Don't include disabled <link>s in link-blocking-first-paint audit - #911
Audit: Handle undefined Accessibility violations array - #942
Audit: Only create a manifest display debugString when there is an error - #954
Audit: Look for non-async <link>s and fix unit of time in link-blocking-first-paint audit - #963
CLI: Add main field to CLI's package.json - #875
CLI: Disable Chrome's Google Translate service during Lighthouse run - #897
CLI: Disable Chrome's default Apps during Lighthouse run - #918
Driver: Dedupe function call site entries on location, not stack trace - #958
Extension: Properly filter the audits to run - #946
Gatherer: Handle CSS parse errors in stylesheet gatherer - #906
Report: Move gt handlebars helper to accessibility formatter - #929
Report: Fix handlebars and helper to show displayValue in reports - #938

Testing

Add DBW to smokehouse tests - #843, #901
Add script for bumping Travis to restart timing-out test runs - #913
Fix Travis timeouts by rerunning with random Chrome debug ports - #922

Docs

Audit: Update EQT/EIL design doc links to latest docs - #923
Audit: Fix no-datenow helpText typo - #955
Audit: Update uses-passive-event-listeners description text - #956
readme: Add DBW to readme - #863
readme: Update development section with TypeScript info - #859
readme: Document yarn install command - #939

Refactor

Audit: Rewrite geolocation-on-start audit to use DBW tooling and testing - #903
CLI: Migrate chrome-debug binary to use internal Chrome launcher - #898
Report: Refactor report generation to be blob based and simpler - #908

Dependencies

Yarn lock file cleanup - 3e9e88c

1.1.7 (2016-10-31)

full changelog

Features

Add cpu throttling option (initially disabled by default) - #747
Stop Lighthouse run if tabs with a shared Service Worker are found - #639
Add Web Worker entry point to lighthouse-background.js - #803
Audit: add DBW stylesheet gatherer and old flexbox audit - #767
Audit: adopt Perceptual Speed Index - #785
Audit: add DBW audit for passive event listeners - #830
CLI: add support for using stable Google Chrome on MacOS - #782

Bug Fixes

Fix function call location from driver.captureJSCallUsage - #779
Update driver.captureFunctionCallSites to use updated driver.evaluateAsync - #809
Stop interpreting manifest parse errors as failure to fetch manifest - #823
Update npm run dbw to use new emulation flags - #834
Make network emulation numbers always integers - #839
Trim extendedInfo returned from DBW http2 audit to prevent circular references - #842
Navigate to about:blank before driver setup - #850
Fix handling of errors from the debugging protocol - #853
Stop spreading strings in log - #835
Allow debugger protocol's DOM domain to be redundantly disabled - #861
Remove tab targetId requirement for checking if other tabs will share a service worker - #852
Consistently reject Promises with an Error - #862
Don't throw an error in stylesheet gatherer if no stylesheets are found - #864
CLI: Disable extension system in launched Chrome instance - #771
CLI: make Chrome Launcher respect --quiet flag - #774
CLI: use about:blank as initial URL - #776
CLI: make HTML report have gitignorable filename - #790
CLI: fix outputMode conditional - #846
CLI: add warning if tsc has not been run before use - #857
Report: fix pluralization of "resources" - #773

Testing

Add smokehouse, an end-to-end test runner, and use for smoke tests - #781, #788
Run default smoke tests with full config - #801
Add prefer-const eslint rule - #804
Run well-known-PWA smokehouse tests in CI - #824
Fix several eslint warnings - #831
Test node v6 and v7 explicitly in CI - #832
Add tests for getLogNormalDistribution and getRiskToResponsiveness on TracingProcessor - #806

Docs

CLI: clarify description of --select-chrome flag - #829
readme: add basic instructions for custom audits/gatherers - 8d696af
readme: update module diagram - ee1dc0d
readme: add node debugging getting started tip - #807
readme: add CLI TS development notes - #818
readme: matching parentheses - #855

Refactor

Make web-inspector.js worker friendly - #795
Migrate driver.evaluateAsync to Runtime.evaluate(awaitPromise) - #793
Extract a Connection abstraction from driver - #800
Create connections/ directory for debugger protocol connection classes - #822
CLI: convert CLI to typescript - #702
CLI: split mobile emulation and network emulation into separate --disable-device-emulation and --disable-network-throttling flags - #747
CLI: add more explicit TS typing - #825
Extension: simplify reloading clean state at end of run - #813, #816

Dependencies

Bump speedline to 1.0.3 - #785
Added typescript - #702
Removed chrome-remote-interface; added ws - #800

1.1.6 (2016-10-12)

1.1.6 (f80e121)
Add yarn.lock (#765) (b44e69d)
Fix NaN% in CLI report (#763) (a21ec65), closes #763
Replace instances of 'not unfunctioning' with 'still functional' (#764) (5476243)
Temporarily disable cache contains start_url audit in config (#766) (f444703)
docs: favor installing stable package from npm instead of Github master (4b8ef79)
chore: tweak eslintignore. (fde5452)

1.1.5 (2016-10-10)

full changelog

Features

Enable passing in a custom pauseAfterLoad option #697
Wait until network has settled before considering page as loaded #714
Support dynamic plugins in lighthouse config #730
Audit: add DBW AppCache audit #681, #687
Audit: add DBW WebSQL audit #691
Audit: add DBW requests-should-be-over-h2 audit #700
Audit: add DBW Date.now() -> performance.now() audit #707
Audit: add DBW console.time() -> performance.mark() audit #712
Audit: add DBW document.write() audit #716
CLI: add chrome-debug binary to launch the debuggable standalone chrome #678
CLI: reporter pretty formatting #682
CLI: add npm run dbw to run DoBetterWeb audits #696
Extension: print errors thrown from handlebars #731
Report: add version number #673
Report: add helpText associated with audit results #695
Report: add version number on all report formats #749
Report: tighter vertical whitespace in HTML report #754
Report: add generatedTime property in json output #752
Report: add toggle to display helpText #751

Bug Fixes

Remove old auditWhitelist argument #676
Stop clearing cookies when run #717
Allow updated speedline to display results for traces with fewer than three frames #745
Sort trace events by timestamp before calculating FMP #756
CLI: add support for Windows 10 without Chrome Canary #690
CLI: fix screenshot save via --save-assets #711
CLI: fix --mobile flag #721
Extension: fixes for updated dependencies #734
Report: add fallback font for url heading #674
Testing: loosen path requirement for closure formatter replacement #701
Testing: handle http-redirect gatherer promise rejections #729
Testing: handle https gatherer promise rejections #738
Testing: handle promise rejections in runner testing #739

Refactor

Automatically cache computed artifacts #675
Streamline extensible gather and audit loading #679, #692
Add 'use strict'; to files where it was missing #694
Handle sendCommand promise rejections #703
Rename of some config.json properties #727
Extension: improve queryCurrentTab impl #680
Testing: stronger user-timing test assertions #732
Testing: run coveralls only after build success #733
Testing: fix tests which were unconditionally passing failed assertions #737

Dependencies

Bump catapult/traceviewer to latest #723
Bump chrome-devtools-frontend to 1.0.401423 #724
Bump speedline to 1.0.0 #726
Bump speedline to 1.0.1 (now handles traces with one, two, or three screenshots) #728

1.1.3 (2016-09-06)

1.1.3 (a5bbe23)
about:blank navigation moved to before gatherer.beforeClass() (8cf3841)
add comment on npm explore (5b36ebb)
add context to aggregator error strings (ab96e71)
Add custom config example. Just the perf stuff. (#603) (ef4044a)
Add empty API-and-internals.md doc (fb690be)
add goOffline/goOnline methods to driver (ceb5f36)
added some docs about running LH headless. (8a176e1)
Added test suffix to all tests (e9110bf)
Addresses comments (8c0c05c)
Adds support for custom audits and gatherers (bab838b)
Asset saver test fixup. (d24c91e)
assetsaver. write real traces to disk. (034e9a6)
Attempt to fix the tests (34509b1)
cache start url audit is Alpha (65778d1)
Changed config/index.js to config/config.js (2e717fe)
config/config. (5572aab)
correctly fall back on erroneous manifest display modes (fc10f5b)
delete page reload/navigate logic since we always navigate (1810c61)
eliminate non-functional loadPage cli flag (990a3c7)
filterPasses -> validatePasses (#608) (1fb77ae)
fix audit, gatherer, artifact browserify import (1ddb8b1)
Fix eslint issues in extension (6be4acf)
fix jsconfig for vscode. (02dfba2)
Fixed headless documentation (58e5be5)
Fixes TTI not being counted in overall score (82c5051)
headless docs: adjustments to pr #623 (364ba40)
Introduce computedArtifacts (#583) (c8662e3)
Keep track of the document URL post-redirects (#582) (ac70731)
launch-chrome: inform user about Chrome launch. refactor & cleanup. (fdff2ae)
merge latest manifest/display tests. (af716df)
mocha tests unfortch can't rely on globbing (35e649a)
move manifest parser test to correct directory (35eb5a1)
move SW version test to audit to use possibly redirected URL (46e1458)
Moves from XHR to DevTools Protocol for manifest retrieval (#600) (74690f1)
overwrite loadData only when configured to (b798f89)
parse URLs in Web App Manifest relative to manifest itself (f45ae69)
properly throw debug error when page does not include manifest (6d2ae74)
Readded $DISPLAY (1b14da8)
refactor of gather-runner to clarify lifecycle (8c5e7d1)
Refactor the JSON output. (#567) (703ded6)
Remove find command in runmocha (81653a4)
remove redundant gatherer lifecycle methods (ac2f62d)
rename computed artifact tests. (5d20fa8)
Rename lighthouse-cli tests as well (9ee4c57)
Revamp of the offline.js gatherer (2b39d27)
Revamp smoketest, include offline & SW test (543b422)
review feedback (6add53a)
Run audits sequentially. (8fe81d8)
s/traceName/passName (f300f67)
Save audit list into storage so it's kept for the next run (#595) (5c72d72)
smoke test: clean up backgrounded processes. (74c5f9c)
squish saveArtifacts and saveAssets together. (ea23dbd)
support collecting network records per pass (4ef3c98)
terminology fixes and docs added to extension (8dbd6fa)
Update first-meaningful-paint.js (add0f03)
update offline gatherer to use network recording changes (db69edd)
Update tracing-processor.js (b526eb3)
readme: updates about m52, etc. (54b93b9)
eslint: no longer ignore all of lighthouse-extension (#613) (5e42394)
docs: headless setup. (9cb1536)
README: add link to debugging protocol and viewer (7ba8830)
README: remove outdated install instructions (5996db7)

1.1.2 (2016-08-06)

1.1.2 (0269917)
addressing brendan's review for ALL the brownie points. (685bda0)
bump extension to 1.1.2 (1d745c3)
Fixed links to small buttons (f9de055)
Generate audit list from configJson (1b1cbdf)
Generate audit options in extension from configJSON (a4bfc04)
Update manifest-background-color.js (38ba8a2)

1.1.1 (2016-08-05)

1.1.1 (ed8e056)
Add and adjust cache-start-url test coverage (81e98d0)
Add extra assertions on the state of debugString (c7884d7)
Added audit configurations to extension (561efc2)
bump extension to 1.1.0 (now matches npm module) (699eafd)
bump extension to 1.1.1 (ac4785e)
Clean up CLI logging, moving protocol work to --verbose. (#556) (6663f6b)
cleanTrace acts on the whole trace (fa837c3)
Delete launch-chrome.sh (e90b128)
Fix exception on missing manifest start_url (269b5a8)
handle old and new trace object format (7c9c44f)
Manifest tests: Always use the manifest parser (12bfb3a)
sourcemaps for the extension off, to avoid the 4MB of tax. (bfd3b02)
Tweak to status messages. (b914ea1)

1.1.0 (2016-08-02)

1.1.0 (d9a7f84)
add test for traceviewer's require not throwing. (7293f6e)
bump traceviewer to master. (a628f62)
clarify chrome remote interface var in CLI driver (b6592d4)
cleanup of extension driver attachment and event registration (69622b8)
fix off-by-one error causing Infinity in 100% EIL (2737165)
Fix traceviewer update instructions in README (2f29085)
Fixed version argument in yargs to display current cli version (504ea95)
handle new require for Mann-Whitney U statistics test. (e0e1052)
Improve check for used JS features (#544) (4f43470)
move driver event handling to base class (07b3ccb)
Refactor npm scripts for mocha (59fdea9)
switch to trace viewer's lean_config, instead of including ALL importers. (7202494)
trace reading: only bind to the first tracingComplete event. (fe634e7)
Update readme.md with trace changes. (ab76af1)
extension: Don't lint in the watch loop. (999d3bf)
extension: exclude source-map module from browserified bundles. (61b8de3)
extension: log exceptions to bg page console. (9d9642c)

1.0.6 (2016-07-28)

1.0.6 (e8bb926)
Adds auto-requested geolocation audit (#510) (60a06c5)
Adds content width audit (#493) (f9bdc7f)
Checks cache for start URL (#507) (4a66309)
Cleanup harmony scripts #513 (#516) (da09ffb)
compat note about firstContentfulPaint trace event. (3e81a6d)
config requires absolute paths (9560a42)
delete lighthouse-core/package.json (d07719e)
Do the last (clean-state) reload in parallel with finishing the report (#522) (c14e7a3)
Extension popup: styling (50c3ced)
Faster smoketest. Fix Flaky works-offline gather (#506) (2fdde48), closes #506
Fix (and speed up) extension browserify post-config refactor. (#499) (563ae0c), closes #499
Fix cachecontents test on HTTP pages (e6fa594)
Fix scoring exception in handlebars (#509) (bcff128), closes #509
Fixes lint errors (bd5f8e1)
Handles ports for SW. (#535) (8c39f91), closes #532
incl critical-request-chains in traceprocessor example (4636ffe)
manifest display must be one of the 3 allowed values. (98c4980)
move driver/ to gather/ (35d0360)
Moved everything from lighthouse-core to ligthouse (1b998a3)
note about excluded cpu profile trace category. (4f66e0d)
Removes the 'module' folder from main. (07e4958)
Removes unused test (3585eef)
rename gatherer base class to gatherer (0c7bef7)
Reuse existing tab fallback (for Chrome headless) (27d3ed8)
Show the test progress (#517) (ffde8e7)
Skip offline-ready smoketest (#520) (5d97d38)
smoke test: simplify --harmony branching. check for viewport (d45883a)
This is a 0.1 definition of Time to Interactive (TTI) which considers (d0d3829)
Trace buckets (#531) (1275762)
Traces that are passed in through the config file are cleaned (1c62db3)
update error message on failed connection to use the npm explore npm run chrome cmd (466beff)
Update manifest-display.js (3b3e3de)
Wait for trace data to arrive before continuing (#541) (df6e013)
tti: simplify logic grabbing 85% vis complete (3906dee)
smoketest: do full default run against our basic html page. (#534) (3e632f9)
cli: use logger to print status messages (#530) (cc3cca4)
travis: force install extension deps. (b17f026)
readme: include CLI flags (d34e5bb)
readme: notes for config & trace-processor usage (eb81929)
readme: notes on node/chrome version compat (d960c79)
readme: update dep graph visualization (0435803)
Travis: enable testing of node v4 + --harmony (#501) (fe5f57d)

1.0.5 (2016-07-08)

1.0.5 (90ffa1a)
CLI shouldn't necc exit on semver check (dec44de)
Install child folder deps through helper script (#500) (e28ee77)

Files

changelog.md

Latest commit

History

changelog.md

File metadata and controls

5.1.0 (2019-05-30)

New contributors!

Core

Report

Clients

CLI

Docs

I18n

Misc

Tests

5.0.0 (2019-05-07)

Major new features

New Audits

Breaking changes

New contributors!

Core

Report

Clients

Docs

CLI

Deps

Tests

I18n

Misc

4.3.1 (2019-04-30)

Core

Clients

Deps

Misc

4.3.0 (2019-04-08)

New contributors!

Report

Core

Docs

Clients

Tests

Misc

Deps

I18n

4.2.0 (2019-03-06)

New contributors!

New Audits

CLI

Core

Deps

Docs

I18n

Report

Tests

Misc

4.1.0 (2019-01-28)

New contributors!

Core

Refactor

Report / Viewer

Misc

4.0.0 (2019-01-16)

New contributors!

Major changes

Breaking changes

Core

Deps

Docs

Extension

I18n

Report

Tests

Misc

4.0.0-beta (2018-11-29)

Core

Report

CLI

Tests

Misc