lighthouse 13.1.0 → 13.3.0

package/cli/bin.js

@@ -107,6 +107,11 @@ async function begin() {
     cliFlags.precomputedLanternData = data;
   }
 
+  if (!Array.isArray(cliFlags.chromeFlags)) {
+    cliFlags.chromeFlags = [cliFlags.chromeFlags];
+  }
+  cliFlags.chromeFlags.push('--enable-features=DevToolsWebMCPSupport');
+
   // By default, cliFlags.enableErrorReporting is undefined so the user is
   // prompted. This can be overridden with an explicit flag or by the cached
   // answer returned by askPermission().

package/cli/cli-flags.js

@@ -54,7 +54,7 @@ function getYargsParser(manualArgv) {
         'Path to JSON file of HTTP Header key/value pairs to send in requests')
     .example(
         'lighthouse <url> --only-categories=performance,seo',
-        'Only run the specified categories. Available categories: accessibility, best-practices, performance, seo')
+        'Only run the specified categories. Available categories: accessibility, best-practices, performance, seo, agentic-browsing')
 
     // We only have the single string positional argument, the url.
     .option('_', {
@@ -188,7 +188,7 @@ function getYargsParser(manualArgv) {
         array: true,
         type: 'string',
         coerce: splitCommaSeparatedValues,
-        describe: 'Only run the specified categories. Available categories: accessibility, best-practices, performance, seo',
+        describe: 'Only run the specified categories. Available categories: accessibility, best-practices, performance, seo, agentic-browsing',
       },
       'skip-audits': {
         array: true,

package/cli/test/smokehouse/lighthouse-runners/bundle.js

@@ -80,11 +80,15 @@ async function runBundledLighthouse(url, config, testRunnerOptions) {
   const thirdPartyWeb = global.thirdPartyWeb;
   thirdPartyWeb.provideThirdPartyWeb(thirdPartyWebLib);
 
+  const chromeFlags = [];
+  if (testRunnerOptions?.headless) chromeFlags.push('--headless=new');
+  if (testRunnerOptions?.chromeFlags) {
+    chromeFlags.push(...testRunnerOptions.chromeFlags.split(' '));
+  }
+
   // Launch and connect to Chrome.
   const launchedChrome = await ChromeLauncher.launch({
-    chromeFlags: [
-      testRunnerOptions?.headless ? '--headless=new' : '',
-    ],
+    chromeFlags,
   });
   const port = launchedChrome.port;
 

package/cli/test/smokehouse/lighthouse-runners/cli.js

@@ -66,7 +66,11 @@ async function internalRun(url, tmpPath, config, logger, options) {
     '--quiet',
   ];
 
-  if (headless) args.push('--chrome-flags="--headless=new"');
+  let chromeFlags = '';
+  if (headless) chromeFlags += '--headless=new ';
+  if (options && options.chromeFlags) chromeFlags += options.chromeFlags;
+
+  if (chromeFlags) args.push(`--chrome-flags="${chromeFlags.trim()}"`);
 
   // Config can be optionally provided.
   if (config) {

package/cli/test/smokehouse/lighthouse-runners/devtools-mcp.js

@@ -56,11 +56,15 @@ async function runBundledLighthouse(url, config, testRunnerOptions) {
   // Load bundle.
   const {navigation} = await import(LH_ROOT + '/dist/lighthouse-devtools-mcp-bundle.js');
 
+  const chromeFlags = [];
+  if (testRunnerOptions?.headless) chromeFlags.push('--headless=new');
+  if (testRunnerOptions?.chromeFlags) {
+    chromeFlags.push(...testRunnerOptions.chromeFlags.split(' '));
+  }
+
   // Launch and connect to Chrome.
   const launchedChrome = await ChromeLauncher.launch({
-    chromeFlags: [
-      testRunnerOptions?.headless ? '--headless=new' : '',
-    ],
+    chromeFlags,
   });
   const port = launchedChrome.port;
 

package/cli/test/smokehouse/lighthouse-runners/devtools.js

@@ -46,9 +46,12 @@ async function setup() {
  */
 async function runLighthouse(url, config, logger, testRunnerOptions) {
   const chromeFlags = [
-    testRunnerOptions?.headless ? '--headless=new' : '',
     `--custom-devtools-frontend=file://${devtoolsDir}/out/LighthouseIntegration/gen/front_end`,
   ];
+  if (testRunnerOptions?.headless) chromeFlags.push('--headless=new');
+  if (testRunnerOptions?.chromeFlags) {
+    chromeFlags.push(...testRunnerOptions.chromeFlags.split(' '));
+  }
   // TODO: `testUrlFromDevtools` should accept a logger, so we get some output even for time outs.
   const {lhr, artifacts, logs} = await testUrlFromDevtools(url, {
     config,

package/cli/test/smokehouse/smokehouse.js

@@ -136,7 +136,7 @@ function purpleify(str) {
  * @return {Promise<SmokehouseResult>}
  */
 async function runSmokeTest(smokeTestDefn, testOptions) {
-  const {id, expectations, config} = smokeTestDefn;
+  const {id, expectations, config, testRunnerOptions: customTestRunnerOptions} = smokeTestDefn;
   const {
     lighthouseRunner,
     retries,
@@ -145,6 +145,11 @@ async function runSmokeTest(smokeTestDefn, testOptions) {
   } = testOptions;
   const requestedUrl = expectations.lhr.requestedUrl;
 
+  const mergedTestRunnerOptions = {
+    ...testRunnerOptions,
+    ...customTestRunnerOptions,
+  };
+
   console.log(`${purpleify(id)} smoketest starting…`);
 
   // Rerun test until there's a passing result or retries are exhausted to prevent flakes.
@@ -170,7 +175,7 @@ async function runSmokeTest(smokeTestDefn, testOptions) {
           reject(new Error('Timed out waiting for provided lighthouseRunner')), 1000 * 120);
       });
       const timedResult = await Promise.race([
-        lighthouseRunner(requestedUrl, config, logger, testRunnerOptions),
+        lighthouseRunner(requestedUrl, config, logger, mergedTestRunnerOptions),
         timeoutPromise,
       ]);
       result = {

package/core/audits/accessibility/autocomplete-valid.d.ts

@@ -0,0 +1,10 @@
+export default AutocompleteValid;
+declare class AutocompleteValid extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=autocomplete-valid.d.ts.map

package/core/audits/accessibility/autocomplete-valid.js

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures the autocomplete attribute is correct and suitable for the form field.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if all form fields have valid autocomplete attributes. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: '`autocomplete` attributes are used correctly',
+  /** Title of an accessibility audit that evaluates if all form fields have valid autocomplete attributes. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: '`autocomplete` attributes are not used correctly',
+  /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
+  description: 'The `autocomplete` attribute values must be valid and correctly applied for ' +
+      'screen readers to function correctly. ' +
+      '[Learn more about valid autocomplete values](https://dequeuniversity.com/rules/axe/4.11/autocomplete-valid).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class AutocompleteValid extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'autocomplete-valid',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default AutocompleteValid;
+export {UIStrings};

package/core/audits/accessibility/presentation-role-conflict.d.ts

@@ -0,0 +1,10 @@
+export default PresentationRoleConflict;
+declare class PresentationRoleConflict extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=presentation-role-conflict.d.ts.map

package/core/audits/accessibility/presentation-role-conflict.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures elements which are marked to be removed from the accessibility tree are in fact removed.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if elements with presentation role have conflicts. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: 'Elements with `role="none"` or `role="presentation"` do not have conflicts',
+  /** Title of an accessibility audit that evaluates if elements with presentation role have conflicts. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: 'Elements with `role="none"` or `role="presentation"` have conflicts',
+  /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with \'Learn\' becomes link text to additional documentation. */
+  description: 'There are certain cases where the semantic role of an element with `role="none"` ' +
+      'or `role="presentation"` does not resolve to none or presentation. To ensure the ' +
+      'element remains removed from the accessibility tree, you should not add any global ' +
+      'ARIA attributes to the element or make it focusable. ' +
+      '[Learn more about presentation role conflict](https://dequeuniversity.com/rules/axe/4.11/presentation-role-conflict).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class PresentationRoleConflict extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'presentation-role-conflict',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default PresentationRoleConflict;
+export {UIStrings};

package/core/audits/accessibility/svg-img-alt.d.ts

@@ -0,0 +1,10 @@
+export default SvgImgAlt;
+declare class SvgImgAlt extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=svg-img-alt.d.ts.map

package/core/audits/accessibility/svg-img-alt.js

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures SVG elements with an img role have an accessible text alternative.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if SVG elements with an img role have an accessible text alternative. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: 'SVG elements with an `img` role have an accessible text alternative',
+  /** Title of an accessibility audit that evaluates if SVG elements with an img role have an accessible text alternative. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: 'SVG elements with an `img` role do not have an accessible text alternative',
+  /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with \'Learn\' becomes link text to additional documentation. */
+  description: 'Ensures SVG elements with an `img`, `graphics-document` or `graphics-symbol` ' +
+      'role have an accessible text alternative. ' +
+      '[Learn more about SVG alt text](https://dequeuniversity.com/rules/axe/4.11/svg-img-alt).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class SvgImgAlt extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'svg-img-alt',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default SvgImgAlt;
+export {UIStrings};

package/core/audits/agentic/agent-accessibility-tree.d.ts

@@ -0,0 +1,19 @@
+export default AgentAccessibilityTree;
+declare class AgentAccessibilityTree extends Audit {
+    /**
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.Audit.Product}
+     */
+    static audit(artifacts: LH.Artifacts): LH.Audit.Product;
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+    let columnRule: string;
+    let columnElement: string;
+    let failedSectionTitle: string;
+    let displayValuePassed: string;
+}
+import { Audit } from '../audit.js';
+//# sourceMappingURL=agent-accessibility-tree.d.ts.map

package/core/audits/agentic/agent-accessibility-tree.js

@@ -0,0 +1,115 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {Audit} from '../audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title shown when all agent accessibility checks pass. */
+  title: 'Accessibility tree is well-formed',
+  /** Title shown when one or more agent accessibility checks fail. */
+  failureTitle: 'Accessibility tree is not well-formed',
+  /** Description of a Lighthouse audit that tells the user *why* they need a well-formed accessibility tree. */
+  description: 'A well-formed [accessibility tree](http://goo.gle/lighthouse-agentic-a11y) helps AI agents to ' +
+    'navigate and interact with the page.',
+  /** Label of a table column that identifies the accessibility rule that failed. */
+  columnRule: 'Failing Rule',
+  /** Label of a table column that identifies the HTML element that failed the rule. */
+  columnElement: 'Failing Element',
+  /** Title of the section containing failed accessibility checks. */
+  failedSectionTitle: 'Failed Audits',
+  /** Message shown when all accessibility checks pass. */
+  displayValuePassed: 'All audits passed',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+const TARGET_RULES = new Set([
+  'button-name',
+  'input-button-name',
+  'input-image-alt',
+  'label',
+  'link-name',
+  'select-name',
+  'document-title',
+  'aria-allowed-attr',
+  'aria-allowed-role',
+  'aria-command-name',
+  'aria-conditional-attr',
+  'aria-dialog-name',
+  'aria-hidden-body',
+  'aria-hidden-focus',
+  'aria-input-field-name',
+  'aria-prohibited-attr',
+  'aria-required-attr',
+  'aria-required-children',
+  'aria-required-parent',
+  'aria-roles',
+  'aria-text',
+  'aria-toggle-field-name',
+  'aria-tooltip-name',
+  'aria-treeitem-name',
+  'aria-valid-attr',
+  'aria-valid-attr-value',
+  'duplicate-id-aria',
+  'definition-list',
+  'table-duplicate-name',
+  'tabindex',
+  'autocomplete-valid',
+  'presentation-role-conflict',
+  'svg-img-alt',
+]);
+
+class AgentAccessibilityTree extends Audit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'agent-accessibility-tree',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+
+  /**
+   * @param {LH.Artifacts} artifacts
+   * @return {LH.Audit.Product}
+   */
+  static audit(artifacts) {
+    const violations = (artifacts.Accessibility && artifacts.Accessibility.violations) || [];
+    const failedRules = violations.filter(v => TARGET_RULES.has(v.id));
+
+    /** @type {LH.Audit.Details.Table['headings']} */
+    const headings = [
+      {key: 'description', valueType: 'text', label: str_(i18n.UIStrings.columnDescription)},
+      {key: 'node', valueType: 'node', label: str_(UIStrings.columnElement)},
+    ];
+
+    const items = failedRules.map(rule => ({
+      description: rule.help || rule.description,
+      node: rule.nodes?.[0] ? Audit.makeNodeItem(rule.nodes[0].node) : undefined,
+    }));
+
+    const listItems = [];
+
+    if (items.length > 0) {
+      const table = Audit.makeTableDetails(headings, items);
+      listItems.push(Audit.makeListDetailSectionItem(table, str_(UIStrings.failedSectionTitle)));
+    }
+
+    return {
+      score: Number(items.length === 0),
+      details: listItems.length > 0 ? Audit.makeListDetails(listItems) : undefined,
+      displayValue: items.length === 0 ? str_(UIStrings.displayValuePassed) : undefined,
+    };
+  }
+}
+
+export default AgentAccessibilityTree;
+export {UIStrings};

package/core/audits/agentic/llms-txt.d.ts

@@ -0,0 +1,20 @@
+export default LlmsTxt;
+declare class LlmsTxt extends Audit {
+    /**
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.Audit.Product}
+     */
+    static audit(artifacts: LH.Artifacts): LH.Audit.Product;
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+    let displayValueHttpBadCode: string;
+    let explanation: string;
+    let missingH1: string;
+    let tooShort: string;
+    let missingLinks: string;
+}
+import { Audit } from '../audit.js';
+//# sourceMappingURL=llms-txt.d.ts.map

package/core/audits/agentic/llms-txt.js

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {Audit} from '../audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const HTTP_CLIENT_ERROR_CODE_LOW = 400;
+const HTTP_SERVER_ERROR_CODE_LOW = 500;
+
+const UIStrings = {
+  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file follows community recommendations. */
+  title: 'llms.txt follows recommendations',
+  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file does not follow community recommendations. */
+  failureTitle: 'llms.txt does not follow recommendations',
+  /** Description of a Lighthouse audit that tells the user *why* they should have an llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This is displayed after a user expands the section to see more. No character length limits. */
+  description: 'If your llms.txt file does not follow recommendations, ' +
+    'large language models may not be able to ' +
+    'understand how you want your website to be crawled or used for training. The ' +
+    '[llms.txt](https://llmstxt.org/) file should be a Markdown file containing at least one H1 header.',
+  /**
+   * @description Label for the audit identifying that the request failed with a specific HTTP status code.
+   * @example {500} statusCode
+   * */
+  displayValueHttpBadCode: 'Failed with HTTP status {statusCode}',
+  /** Explanatory message stating that there was a failure in an audit caused by Lighthouse not being able to download the llms.txt file for the site.  Note: "llms.txt" is a canonical filename and should not be translated. */
+  explanation: 'Fetch of llms.txt failed',
+  /** Message indicating that the file is missing a required H1 header. */
+  missingH1: 'File is missing a required H1 header (e.g., "# Title").',
+  /** Message indicating that the file is suspiciously short. */
+  tooShort: 'File is suspiciously short.',
+  /** Message indicating that the file is missing links. */
+  missingLinks: 'File does not appear to contain any links.',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class LlmsTxt extends Audit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'llms-txt',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['LlmsTxt'],
+    };
+  }
+
+  /**
+   * @param {LH.Artifacts} artifacts
+   * @return {LH.Audit.Product}
+   */
+  static audit(artifacts) {
+    const {
+      status,
+      content,
+    } = artifacts.LlmsTxt;
+
+    if (!status) {
+      return {
+        score: 0,
+        explanation: str_(UIStrings.explanation),
+      };
+    }
+
+    if (status >= HTTP_SERVER_ERROR_CODE_LOW) {
+      return {
+        score: 0,
+        displayValue: str_(UIStrings.displayValueHttpBadCode, {statusCode: status}),
+      };
+    } else if (status >= HTTP_CLIENT_ERROR_CODE_LOW) {
+      return {
+        score: 1,
+        notApplicable: true,
+      };
+    }
+
+    if (content === null) {
+      throw new Error(`Status ${status} was valid, but content was null`);
+    }
+
+    const hasH1 = /^#\s+.+/m.test(content);
+    const hasLink = /\[.+\]\(.+\)/.test(content);
+    const isTooShort = content.length < 50;
+
+    const errors = [];
+    if (!hasH1) errors.push(str_(UIStrings.missingH1));
+    if (!hasLink) errors.push(str_(UIStrings.missingLinks));
+    if (isTooShort) errors.push(str_(UIStrings.tooShort));
+
+    /** @type {LH.Audit.Details.Table['headings']} */
+    const headings = [
+      {key: 'message', valueType: 'text', label: 'Error'},
+    ];
+
+    const details = Audit.makeTableDetails(headings, errors.map(m => ({message: m})));
+
+    return {
+      score: Number(errors.length === 0),
+      details: errors.length ? details : undefined,
+    };
+  }
+}
+
+export default LlmsTxt;
+export {UIStrings};

package/core/audits/insights/insight-audit.d.ts

@@ -11,11 +11,11 @@ export type CreateDetailsExtras = {
  * @param {LH.Artifacts} artifacts
  * @param {LH.Audit.Context} context
  * @param {T} insightName
- * @param {(insight: import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModels[T], extras: CreateDetailsExtras) => {details: LH.Audit.Details, warnings?: Array<string | LH.IcuMessage>, numericValue?: number, numericUnit?: LH.Audit.NumericProduct['numericUnit']}|LH.Audit.Details|undefined} createDetails
+ * @param {(insight: NonNullable<import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModels[T]>, extras: CreateDetailsExtras) => {details: LH.Audit.Details, warnings?: Array<string | LH.IcuMessage>, numericValue?: number, numericUnit?: LH.Audit.NumericProduct['numericUnit']}|LH.Audit.Details|undefined} createDetails
  * @template {keyof import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModelsType} T
  * @return {Promise<LH.Audit.Product>}
  */
-export function adaptInsightToAuditProduct<T extends keyof import("@paulirish/trace_engine/models/trace/insights/types.js").InsightModelsType>(artifacts: LH.Artifacts, context: LH.Audit.Context, insightName: T, createDetails: (insight: import("@paulirish/trace_engine/models/trace/insights/types.js").InsightModels[T], extras: CreateDetailsExtras) => {
+export function adaptInsightToAuditProduct<T extends keyof import("@paulirish/trace_engine/models/trace/insights/types.js").InsightModelsType>(artifacts: LH.Artifacts, context: LH.Audit.Context, insightName: T, createDetails: (insight: NonNullable<import("@paulirish/trace_engine/models/trace/insights/types.js").InsightModels[T]>, extras: CreateDetailsExtras) => {
     details: LH.Audit.Details;
     warnings?: Array<string | LH.IcuMessage>;
     numericValue?: number;

package/core/audits/insights/insight-audit.js

@@ -27,8 +27,10 @@ async function getInsightSet(artifacts, context) {
     await TraceEngineResult.request({trace, settings, SourceMaps, HostDPR}, context);
 
   const navigationId = processedTrace.timeOriginEvt.args.data?.navigationId;
-  const key = navigationId ?? NO_NAVIGATION;
-  const insights = traceEngineResult.insights.get(key);
+  const insights = navigationId ?
+    [...traceEngineResult.insights.values()]
+      .find(insightSet => insightSet.navigation?.args.data?.navigationId) :
+    traceEngineResult.insights.get(NO_NAVIGATION);
 
   return {insights, data: traceEngineResult.data};
 }
@@ -43,7 +45,7 @@ async function getInsightSet(artifacts, context) {
  * @param {LH.Artifacts} artifacts
  * @param {LH.Audit.Context} context
  * @param {T} insightName
- * @param {(insight: import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModels[T], extras: CreateDetailsExtras) => {details: LH.Audit.Details, warnings?: Array<string | LH.IcuMessage>, numericValue?: number, numericUnit?: LH.Audit.NumericProduct['numericUnit']}|LH.Audit.Details|undefined} createDetails
+ * @param {(insight: NonNullable<import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModels[T]>, extras: CreateDetailsExtras) => {details: LH.Audit.Details, warnings?: Array<string | LH.IcuMessage>, numericValue?: number, numericUnit?: LH.Audit.NumericProduct['numericUnit']}|LH.Audit.Details|undefined} createDetails
  * @template {keyof import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModelsType} T
  * @return {Promise<LH.Audit.Product>}
  */
@@ -56,11 +58,19 @@ async function adaptInsightToAuditProduct(artifacts, context, insightName, creat
     };
   }
 
+  const error = insights.modelErrors[insightName];
+  if (error) {
+    return {
+      errorMessage: error.message,
+      errorStack: error.stack,
+      score: null,
+    };
+  }
+
   const insight = insights.model[insightName];
-  if (insight instanceof Error) {
+  if (!insight) {
     return {
-      errorMessage: insight.message,
-      errorStack: insight.stack,
+      scoreDisplayMode: Audit.SCORING_MODES.NOT_APPLICABLE,
       score: null,
     };
   }

package/core/audits/layout-shifts.js

@@ -73,7 +73,7 @@ class LayoutShifts extends Audit {
       layoutShifts: new Map(),
     };
     for (const insightSet of traceEngineResult.insights.values()) {
-      for (const [shift, reasons] of insightSet.model.CLSCulprits.shifts) {
+      for (const [shift, reasons] of insightSet.model.CLSCulprits?.shifts ?? []) {
         allRootCauses.layoutShifts.set(shift, reasons);
       }
     }

package/core/audits/server-response-time.js

@@ -51,15 +51,15 @@ class ServerResponseTime extends Audit {
     const {SourceMaps, HostDPR} = artifacts;
     const navInsights =
       await NavigationInsights.request({trace, settings, SourceMaps, HostDPR}, context);
-    const responseTime = navInsights.model.DocumentLatency.data?.serverResponseTime;
-    const url = navInsights.model.DocumentLatency.data?.documentRequest?.args.data.url;
+    const responseTime = navInsights.model.DocumentLatency?.data?.serverResponseTime;
+    const url = navInsights.model.DocumentLatency?.data?.documentRequest?.args.data.url;
 
     if (responseTime === undefined || !url) {
       throw new Error('no timing found for main resource');
     }
 
     const passed =
-      Boolean(navInsights.model.DocumentLatency.data?.checklist.serverResponseIsFast.value);
+      Boolean(navInsights.model.DocumentLatency?.data?.checklist.serverResponseIsFast.value);
     const displayValue = str_(UIStrings.displayValue, {timeInMs: responseTime});
 
     /** @type {LH.Audit.Details.Opportunity['headings']} */