Skip to content

support for lh v13#69

Merged
iBombit merged 2 commits intomainfrom
feature/lh_v13.0.3
Mar 4, 2026
Merged

support for lh v13#69
iBombit merged 2 commits intomainfrom
feature/lh_v13.0.3

Conversation

@iBombit
Copy link
Owner

@iBombit iBombit commented Mar 4, 2026

🚀 Lighthouse v13 Migration + Network Waterfall

Problem

Lighthouse v13 (#16595) removed 24 performance audits that were replaced by insight audits. Our reports were breaking — missing data in metric-relevant-audit mappings, and custom audits failing due to renamed artifact keys.

What changed

v13 Compatibility Fixes

Area Before (v12) After (v13)
Artifact keys requiredArtifacts: ['traces'] requiredArtifacts: ['Trace']
Artifact access artifacts.traces[Audit.DEFAULT_PASS] artifacts.Trace
DevtoolsLog key artifacts.devtoolsLogs[Audit.DEFAULT_PASS] artifacts.DevtoolsLog
i18n import import i18n from '...' import * as i18n from '...'
Metric audit refs render-blocking-resources, server-response-time, etc. render-blocking-insight, server-response-time-insight, etc.
CSV thresholds Referenced uses-optimized-images, uses-text-compression Removed (consolidated into insight audits)

Files affected: all 11 custom audits, metrics-to-audits.js, csv.js

Network Waterfall Visualization (new)

Added an inline SVG waterfall chart that renders inside each Lighthouse report step:

  • Horizontal bars color-coded by MIME type (JS · CSS · HTML · Image · Font · JSON)
  • Requests grouped by third-party entity with transfer size + duration summaries
  • Vertical timing markers for FCP, LCP, DCL, Page Load
  • Hover tooltips with full URL, timing, size, status code
  • Auto-scaled time axis with gridlines
  • 1st-party requests rendered in bold

New files:

  • settings/audits/network-waterfall.js — custom audit embedding the SVG via valueType: 'thumbnail'
  • reporting/waterfall.jsbuildWaterfallSVG() generator

Modified:

  • settings/lighthouse.js — registered network-waterfall audit in server-side category
  • reporting/createReport.js — injects CSS overrides so the SVG renders at full width

Network Requests Table Cleanup

Before After
7 columns incl. redundant End Time 6 columns — End Time removed
Labels like Network Request Time Short: Start · Duration · Transfer · Resource · Status · Type
Flat list, arbitrary order Grouped by entity, sorted by start time
No size granularity hints granularity: 1 + displayUnit: 'kb'

Screenshots

image

Testing

npx mocha --timeout 10000 .\test\demo.test.steps.js --browsertype=desktop --headless=false --url="https://demoqa.com/" --configFile=customConfig.json

Verified:

  • All 11 custom audits load and produce results on v13.0.3
  • Waterfall SVG renders inline in HTML report per step
  • CSV, Slack, Teams, Datadog, InfluxDB reporters unaffected
  • No regressions on desktop/mobile/3G/4G profiles

Breaking Changes

None for consumers — this is a drop-in upgrade. The framework now requires Lighthouse ≥ 13.0.0.

@iBombit iBombit self-assigned this Mar 4, 2026
@iBombit iBombit merged commit 94636f7 into main Mar 4, 2026
1 of 3 checks passed
@iBombit iBombit deleted the feature/lh_v13.0.3 branch March 4, 2026 18:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant