lighthouse 12.4.0-dev.20250311 → 12.4.0-dev.20250313

package/core/audits/layout-shifts.js

@@ -57,8 +57,9 @@ class LayoutShifts extends Audit {
    * @return {Promise<LH.Audit.Product>}
    */
   static async audit(artifacts, context) {
+    const settings = context.settings;
     const trace = artifacts.traces[Audit.DEFAULT_PASS];
-    const traceEngineResult = await TraceEngineResult.request({trace}, context);
+    const traceEngineResult = await TraceEngineResult.request({trace, settings}, context);
     const clusters = traceEngineResult.data.LayoutShifts.clusters ?? [];
     const {cumulativeLayoutShift: clsSavings, impactByNodeId} =
       await CumulativeLayoutShiftComputed.request(trace, context);

package/core/audits/long-tasks.js

@@ -192,7 +192,8 @@ class LongTasks extends Audit {
       taskTimingsByEvent = new Map();
 
       const simulatorOptions = {devtoolsLog, settings: context.settings};
-      const pageGraph = await PageDependencyGraph.request({trace, devtoolsLog, URL}, context);
+      const pageGraph =
+        await PageDependencyGraph.request({settings, trace, devtoolsLog, URL}, context);
       const simulator = await LoadSimulator.request(simulatorOptions, context);
       const simulation = await simulator.simulate(pageGraph, {label: 'long-tasks-diagnostic'});
       for (const [node, timing] of simulation.nodeTimings.entries()) {

package/core/audits/script-treemap-data.js

@@ -114,8 +114,12 @@ class ScriptTreemapDataAudit extends Audit {
      */
     function collapseAll(node) {
       while (node.children && node.children.length === 1) {
-        node.name += '/' + node.children[0].name;
-        node.children = node.children[0].children;
+        const child = node.children[0];
+        node.name += '/' + child.name;
+        if (child.duplicatedNormalizedModuleName) {
+          node.duplicatedNormalizedModuleName = child.duplicatedNormalizedModuleName;
+        }
+        node.children = child.children;
       }
 
       if (node.children) {

package/core/audits/uses-rel-preconnect.js

@@ -137,7 +137,7 @@ class UsesRelPreconnectAudit extends Audit {
         MainResource.request({devtoolsLog, URL: artifacts.URL}, context),
         LoadSimulator.request({devtoolsLog, settings}, context),
         ProcessedNavigation.request(trace, context),
-        PageDependencyGraph.request({trace, devtoolsLog, URL: artifacts.URL}, context),
+        PageDependencyGraph.request({settings, trace, devtoolsLog, URL: artifacts.URL}, context),
       ]);
 
     const {rtt, additionalRttByOrigin} = loadSimulator.getOptions();

package/core/audits/uses-rel-preload.js

@@ -212,6 +212,7 @@ class UsesRelPreloadAudit extends Audit {
    * @return {Promise<LH.Audit.Product>}
    */
   static async audit(artifacts, context) {
+    const settings = context.settings;
     const trace = artifacts.traces[UsesRelPreloadAudit.DEFAULT_PASS];
     const devtoolsLog = artifacts.devtoolsLogs[UsesRelPreloadAudit.DEFAULT_PASS];
     const URL = artifacts.URL;
@@ -219,7 +220,7 @@ class UsesRelPreloadAudit extends Audit {
 
     const [mainResource, graph, simulator] = await Promise.all([
       MainResource.request({devtoolsLog, URL}, context),
-      PageDependencyGraph.request({trace, devtoolsLog, URL}, context),
+      PageDependencyGraph.request({settings, trace, devtoolsLog, URL}, context),
       LoadSimulator.request(simulatorOptions, context),
     ]);
 

package/core/computed/critical-request-chains.d.ts

@@ -4,6 +4,7 @@ declare const CriticalRequestChainsComputed: typeof CriticalRequestChains & {
         URL: LH.Artifacts["URL"];
         devtoolsLog: LH.DevtoolsLog;
         trace: LH.Trace;
+        settings: LH.Audit.Context["settings"];
     }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof CriticalRequestChains.compute_>;
 };
 declare class CriticalRequestChains {
@@ -24,7 +25,7 @@ declare class CriticalRequestChains {
      */
     static extractChainsFromGraph(mainResource: LH.Artifacts.NetworkRequest, graph: LH.Gatherer.Simulation.GraphNode): LH.Artifacts.CriticalRequestNode;
     /**
-     * @param {{URL: LH.Artifacts['URL'], devtoolsLog: LH.DevtoolsLog, trace: LH.Trace}} data
+     * @param {{URL: LH.Artifacts['URL'], devtoolsLog: LH.DevtoolsLog, trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
      * @param {LH.Artifacts.ComputedContext} context
      * @return {Promise<LH.Artifacts.CriticalRequestNode>}
      */
@@ -32,6 +33,7 @@ declare class CriticalRequestChains {
         URL: LH.Artifacts["URL"];
         devtoolsLog: LH.DevtoolsLog;
         trace: LH.Trace;
+        settings: LH.Audit.Context["settings"];
     }, context: LH.Artifacts.ComputedContext): Promise<LH.Artifacts.CriticalRequestNode>;
 }
 import * as Lantern from '../lib/lantern/lantern.js';

package/core/computed/critical-request-chains.js

@@ -126,7 +126,7 @@ class CriticalRequestChains {
   }
 
   /**
-   * @param {{URL: LH.Artifacts['URL'], devtoolsLog: LH.DevtoolsLog, trace: LH.Trace}} data
+   * @param {{URL: LH.Artifacts['URL'], devtoolsLog: LH.DevtoolsLog, trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
    * @param {LH.Artifacts.ComputedContext} context
    * @return {Promise<LH.Artifacts.CriticalRequestNode>}
    */
@@ -139,5 +139,5 @@ class CriticalRequestChains {
 }
 
 const CriticalRequestChainsComputed =
-  makeComputedArtifact(CriticalRequestChains, ['URL', 'devtoolsLog', 'trace']);
+  makeComputedArtifact(CriticalRequestChains, ['URL', 'devtoolsLog', 'trace', 'settings']);
 export {CriticalRequestChainsComputed as CriticalRequestChains};

package/core/computed/navigation-insights.d.ts

@@ -1,6 +1,9 @@
 export { NavigationInsightsComputed as NavigationInsights };
 declare const NavigationInsightsComputed: typeof NavigationInsights & {
-    request: (dependencies: import("../index.js").Trace, context: LH.Artifacts.ComputedContext) => ReturnType<typeof NavigationInsights.compute_>;
+    request: (dependencies: {
+        trace: LH.Trace;
+        settings: LH.Audit.Context["settings"];
+    }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof NavigationInsights.compute_>;
 };
 /**
  * @fileoverview Gets insights from the shared trace engine for the navigation audited by Lighthouse.
@@ -8,9 +11,12 @@ declare const NavigationInsightsComputed: typeof NavigationInsights & {
  */
 declare class NavigationInsights {
     /**
-      * @param {LH.Trace} trace
+      * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
       * @param {LH.Artifacts.ComputedContext} context
      */
-    static compute_(trace: LH.Trace, context: LH.Artifacts.ComputedContext): Promise<import("@paulirish/trace_engine/models/trace/insights/types.js").InsightSet>;
+    static compute_(data: {
+        trace: LH.Trace;
+        settings: LH.Audit.Context["settings"];
+    }, context: LH.Artifacts.ComputedContext): Promise<import("@paulirish/trace_engine/models/trace/insights/types.js").InsightSet>;
 }
 //# sourceMappingURL=navigation-insights.d.ts.map

package/core/computed/navigation-insights.js

@@ -14,12 +14,13 @@ import {TraceEngineResult} from './trace-engine-result.js';
  */
 class NavigationInsights {
   /**
-    * @param {LH.Trace} trace
+    * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
     * @param {LH.Artifacts.ComputedContext} context
    */
-  static async compute_(trace, context) {
+  static async compute_(data, context) {
+    const {trace, settings} = data;
     const processedTrace = await ProcessedTrace.request(trace, context);
-    const traceEngineResult = await TraceEngineResult.request({trace}, context);
+    const traceEngineResult = await TraceEngineResult.request({trace, settings}, context);
 
     const navigationId = processedTrace.timeOriginEvt.args.data?.navigationId;
     if (!navigationId) throw new Error('No navigationId found');
@@ -31,5 +32,5 @@ class NavigationInsights {
   }
 }
 
-const NavigationInsightsComputed = makeComputedArtifact(NavigationInsights, null);
+const NavigationInsightsComputed = makeComputedArtifact(NavigationInsights, ['trace', 'settings']);
 export {NavigationInsightsComputed as NavigationInsights};

package/core/computed/page-dependency-graph.d.ts

@@ -3,19 +3,21 @@ declare const PageDependencyGraphComputed: typeof PageDependencyGraph & {
     request: (dependencies: {
         trace: LH.Trace;
         devtoolsLog: LH.DevtoolsLog;
+        settings: LH.Audit.Context["settings"];
         URL: LH.Artifacts["URL"];
         fromTrace?: boolean;
     }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof PageDependencyGraph.compute_>;
 };
 declare class PageDependencyGraph {
     /**
-     * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, URL: LH.Artifacts['URL'], fromTrace?: boolean}} data
+     * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, settings: LH.Audit.Context['settings'], URL: LH.Artifacts['URL'], fromTrace?: boolean}} data
      * @param {LH.Artifacts.ComputedContext} context
      * @return {Promise<LH.Gatherer.Simulation.GraphNode>}
      */
     static compute_(data: {
         trace: LH.Trace;
         devtoolsLog: LH.DevtoolsLog;
+        settings: LH.Audit.Context["settings"];
         URL: LH.Artifacts["URL"];
         fromTrace?: boolean;
     }, context: LH.Artifacts.ComputedContext): Promise<LH.Gatherer.Simulation.GraphNode>;

package/core/computed/page-dependency-graph.js

@@ -13,19 +13,19 @@ import {TraceEngineResult} from './trace-engine-result.js';
 
 class PageDependencyGraph {
   /**
-   * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, URL: LH.Artifacts['URL'], fromTrace?: boolean}} data
+   * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, settings: LH.Audit.Context['settings'], URL: LH.Artifacts['URL'], fromTrace?: boolean}} data
    * @param {LH.Artifacts.ComputedContext} context
    * @return {Promise<LH.Gatherer.Simulation.GraphNode>}
    */
   static async compute_(data, context) {
-    const {trace, devtoolsLog, URL} = data;
+    const {trace, settings, devtoolsLog, URL} = data;
     const [{mainThreadEvents}, networkRecords] = await Promise.all([
       ProcessedTrace.request(trace, context),
       NetworkRecords.request(devtoolsLog, context),
     ]);
 
     if (data.fromTrace) {
-      const traceEngineResult = await TraceEngineResult.request({trace}, context);
+      const traceEngineResult = await TraceEngineResult.request({trace, settings}, context);
       const traceEngineData = traceEngineResult.data;
       const requests =
         Lantern.TraceEngineComputationData.createNetworkRequests(trace, traceEngineData);
@@ -40,6 +40,6 @@ class PageDependencyGraph {
   }
 }
 
-const PageDependencyGraphComputed =
-  makeComputedArtifact(PageDependencyGraph, ['devtoolsLog', 'trace', 'URL', 'fromTrace']);
+const PageDependencyGraphComputed = makeComputedArtifact(PageDependencyGraph,
+  ['devtoolsLog', 'settings', 'trace', 'URL', 'fromTrace']);
 export {PageDependencyGraphComputed as PageDependencyGraph};

package/core/computed/trace-engine-result.d.ts

@@ -2,6 +2,7 @@ export { TraceEngineResultComputed as TraceEngineResult };
 declare const TraceEngineResultComputed: typeof TraceEngineResult & {
     request: (dependencies: {
         trace: LH.Trace;
+        settings: LH.Audit.Context["settings"];
     }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof TraceEngineResult.compute_>;
 };
 /**
@@ -10,9 +11,10 @@ declare const TraceEngineResultComputed: typeof TraceEngineResult & {
 declare class TraceEngineResult {
     /**
      * @param {LH.TraceEvent[]} traceEvents
+     * @param {LH.Audit.Context['settings']} settings
      * @return {Promise<LH.Artifacts.TraceEngineResult>}
      */
-    static runTraceEngine(traceEvents: LH.TraceEvent[]): Promise<LH.Artifacts.TraceEngineResult>;
+    static runTraceEngine(traceEvents: LH.TraceEvent[], settings: LH.Audit.Context["settings"]): Promise<LH.Artifacts.TraceEngineResult>;
     /**
      * Adapts the given DevTools function that returns a localized string to one
      * that returns a LH.IcuMessage.
@@ -45,12 +47,13 @@ declare class TraceEngineResult {
      */
     static localizeInsights(insightSets: import("@paulirish/trace_engine/models/trace/insights/types.js").TraceInsightSets): void;
     /**
-     * @param {{trace: LH.Trace}} data
+     * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
      * @param {LH.Artifacts.ComputedContext} context
      * @return {Promise<LH.Artifacts.TraceEngineResult>}
      */
     static compute_(data: {
         trace: LH.Trace;
+        settings: LH.Audit.Context["settings"];
     }, context: LH.Artifacts.ComputedContext): Promise<LH.Artifacts.TraceEngineResult>;
 }
 import * as LH from '../../types/lh.js';

package/core/computed/trace-engine-result.js

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import log from 'lighthouse-logger';
+
 import * as i18n from '../lib/i18n/i18n.js';
 import * as TraceEngine from '../lib/trace-engine.js';
 import {makeComputedArtifact} from './computed-artifact.js';
@@ -17,15 +19,35 @@ import * as LH from '../../types/lh.js';
 class TraceEngineResult {
   /**
    * @param {LH.TraceEvent[]} traceEvents
+   * @param {LH.Audit.Context['settings']} settings
    * @return {Promise<LH.Artifacts.TraceEngineResult>}
    */
-  static async runTraceEngine(traceEvents) {
+  static async runTraceEngine(traceEvents, settings) {
     const processor = new TraceEngine.TraceProcessor(TraceEngine.TraceHandlers);
 
+    const lanternSettings = {};
+    if (settings.throttlingMethod) lanternSettings.throttlingMethod = settings.throttlingMethod;
+    if (settings.throttling) lanternSettings.throttling = settings.throttling;
+    if (settings.precomputedLanternData) {
+      lanternSettings.precomputedLanternData = settings.precomputedLanternData;
+    }
+
     // eslint-disable-next-line max-len
     await processor.parse(/** @type {import('@paulirish/trace_engine').Types.Events.Event[]} */ (
       traceEvents
-    ), {});
+    ), {
+      logger: {
+        start(id) {
+          const logId = `lh:computed:TraceEngineResult:${id}`;
+          log.time({msg: `Trace Engine ${id}`, id: logId});
+        },
+        end(id) {
+          const logId = `lh:computed:TraceEngineResult:${id}`;
+          log.timeEnd({msg: `Trace Engine ${id}`, id: logId});
+        },
+      },
+      lanternSettings,
+    });
     if (!processor.parsedTrace) throw new Error('No data');
     if (!processor.insights) throw new Error('No insights');
     this.localizeInsights(processor.insights);
@@ -177,7 +199,7 @@ class TraceEngineResult {
   }
 
   /**
-   * @param {{trace: LH.Trace}} data
+   * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
    * @param {LH.Artifacts.ComputedContext} context
    * @return {Promise<LH.Artifacts.TraceEngineResult>}
    */
@@ -207,10 +229,10 @@ class TraceEngineResult {
       }
     }
 
-    const result = await TraceEngineResult.runTraceEngine(traceEvents);
+    const result = await TraceEngineResult.runTraceEngine(traceEvents, data.settings);
     return result;
   }
 }
 
-const TraceEngineResultComputed = makeComputedArtifact(TraceEngineResult, ['trace']);
+const TraceEngineResultComputed = makeComputedArtifact(TraceEngineResult, ['trace', 'settings']);
 export {TraceEngineResultComputed as TraceEngineResult};

package/core/gather/gatherers/trace-elements.js

@@ -386,7 +386,8 @@ class TraceElements extends BaseGatherer {
     const session = context.driver.defaultSession;
 
     const trace = context.dependencies.Trace;
-    const traceEngineResult = await TraceEngineResult.request({trace}, context);
+    const settings = context.settings;
+    const traceEngineResult = await TraceEngineResult.request({trace, settings}, context);
     const rootCauses = context.dependencies.RootCauses;
 
     const processedTrace = await ProcessedTrace.request(trace, context);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lighthouse",
   "type": "module",
-  "version": "12.4.0-dev.20250311",
+  "version": "12.4.0-dev.20250313",
   "description": "Automated auditing, performance metrics, and best practices for the web.",
   "main": "./core/index.js",
   "bin": {
@@ -141,6 +141,7 @@
     "chrome-devtools-frontend": "1.0.1418433",
     "concurrently": "^6.4.0",
     "conventional-changelog-cli": "^2.1.1",
+    "core-js-compat": "^3.41.0",
     "cpy": "^8.1.2",
     "cross-env": "^7.0.2",
     "csv-validator": "^0.0.3",
@@ -183,7 +184,7 @@
     "webtreemap-cdt": "^3.2.1"
   },
   "dependencies": {
-    "@paulirish/trace_engine": "0.0.47",
+    "@paulirish/trace_engine": "0.0.48",
     "@sentry/node": "^7.0.0",
     "axe-core": "^4.10.2",
     "chrome-launcher": "^1.1.2",

package/shared/localization/locales/en-US.json

@@ -660,7 +660,7 @@
     "message": "Use video formats for animated content"
   },
   "core/audits/byte-efficiency/legacy-javascript.js | description": {
-    "message": "Polyfills and transforms enable legacy browsers to use new JavaScript features. However, many aren't necessary for modern browsers. For your bundled JavaScript, adopt a modern script deployment strategy using [module/nomodule feature detection](https://philipwalton.com/articles/deploying-es2015-code-in-production-today/) to reduce the amount of code shipped to modern browsers, while retaining support for legacy browsers. [Learn how to serve modern JavaScript](https://web.dev/articles/codelab-serve-modern-code)"
+    "message": "Polyfills and transforms enable legacy browsers to use new JavaScript features. However, many aren't necessary for modern browsers. Consider modifying your JavaScript build process to not transpile [Baseline](https://web.dev/baseline) features, unless you know you must support legacy browsers. [Learn why most sites can deploy ES6+ code without transpiling](https://philipwalton.com/articles/the-state-of-es5-on-the-web/)"
   },
   "core/audits/byte-efficiency/legacy-javascript.js | detectedCoreJs2Warning": {
     "message": "Version 2 of core-js was detected on the page. You should upgrade to version 3 for many performance improvements."

package/shared/localization/locales/en-XL.json

@@ -660,7 +660,7 @@
     "message": "Ûśê v́îd́êó f̂ór̂ḿât́ŝ f́ôŕ âńîḿât́êd́ ĉón̂t́êńt̂"
   },
   "core/audits/byte-efficiency/legacy-javascript.js | description": {
-    "message": "P̂ól̂ýf̂íl̂ĺŝ án̂d́ t̂ŕâńŝf́ôŕm̂ś êńâb́l̂é l̂éĝáĉý b̂ŕôẃŝér̂ś t̂ó ûśê ńêẃ Ĵáv̂áŜćr̂íp̂t́ f̂éât́ûŕêś. Ĥóŵév̂ér̂, ḿâńŷ ár̂én̂'t́ n̂éĉéŝśâŕŷ f́ôŕ m̂ód̂ér̂ń b̂ŕôẃŝér̂ś. F̂ór̂ ýôúr̂ b́ûńd̂ĺêd́ Ĵáv̂áŜćr̂íp̂t́, âd́ôṕt̂ á m̂ód̂ér̂ń ŝćr̂íp̂t́ d̂ép̂ĺôým̂én̂t́ ŝt́r̂át̂éĝý ûśîńĝ [ḿôd́ûĺê/ńôḿôd́ûĺê f́êát̂úr̂é d̂ét̂éĉt́îón̂](https://philipwalton.com/articles/deploying-es2015-code-in-production-today/) t́ô ŕêd́ûćê t́ĥé âḿôún̂t́ ôf́ ĉód̂é ŝh́îṕp̂éd̂ t́ô ḿôd́êŕn̂ b́r̂óŵśêŕŝ, ẃĥíl̂é r̂ét̂áîńîńĝ śûṕp̂ór̂t́ f̂ór̂ ĺêǵâćŷ b́r̂óŵśêŕŝ. [Ĺêár̂ń ĥóŵ t́ô śêŕv̂é m̂ód̂ér̂ń Ĵáv̂áŜćr̂íp̂t́](https://web.dev/articles/codelab-serve-modern-code)"
+    "message": "P̂ól̂ýf̂íl̂ĺŝ án̂d́ t̂ŕâńŝf́ôŕm̂ś êńâb́l̂é l̂éĝáĉý b̂ŕôẃŝér̂ś t̂ó ûśê ńêẃ Ĵáv̂áŜćr̂íp̂t́ f̂éât́ûŕêś. Ĥóŵév̂ér̂, ḿâńŷ ár̂én̂'t́ n̂éĉéŝśâŕŷ f́ôŕ m̂ód̂ér̂ń b̂ŕôẃŝér̂ś. Ĉón̂śîd́êŕ m̂ód̂íf̂ýîńĝ ýôúr̂ J́âv́âŚĉŕîṕt̂ b́ûíl̂d́ p̂ŕôćêśŝ t́ô ńôt́ t̂ŕâńŝṕîĺê [B́âśêĺîńê](https://web.dev/baseline) f́êát̂úr̂éŝ, ún̂ĺêśŝ ýôú k̂ńôẃ ŷóû ḿûśt̂ śûṕp̂ór̂t́ l̂éĝáĉý b̂ŕôẃŝér̂ś. [L̂éâŕn̂ ẃĥý m̂óŝt́ ŝít̂éŝ ćâń d̂ép̂ĺôý ÊŚ6+ ĉód̂é ŵít̂h́ôút̂ t́r̂án̂śp̂íl̂ín̂ǵ](https://philipwalton.com/articles/the-state-of-es5-on-the-web/)"
   },
   "core/audits/byte-efficiency/legacy-javascript.js | detectedCoreJs2Warning": {
     "message": "V̂ér̂śîón̂ 2 óf̂ ćôŕê-j́ŝ ẃâś d̂ét̂éĉt́êd́ ôń t̂h́ê ṕâǵê. Ýôú ŝh́ôúl̂d́ ûṕĝŕâd́ê t́ô v́êŕŝíôń 3 f̂ór̂ ḿâńŷ ṕêŕf̂ór̂ḿâńĉé îḿp̂ŕôv́êḿêńt̂ś."