lighthouse 13.2.0 → 13.4.0

package/core/computed/metrics/largest-contentful-paint-all-frames.d.ts

@@ -1,6 +1,6 @@
 export { LargestContentfulPaintAllFramesComputed as LargestContentfulPaintAllFrames };
 declare const LargestContentfulPaintAllFramesComputed: typeof LargestContentfulPaintAllFrames & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 declare class LargestContentfulPaintAllFrames extends NavigationMetric {
     /**

package/core/computed/metrics/largest-contentful-paint.d.ts

@@ -1,6 +1,6 @@
 export { LargestContentfulPaintComputed as LargestContentfulPaint };
 declare const LargestContentfulPaintComputed: typeof LargestContentfulPaint & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 declare class LargestContentfulPaint extends NavigationMetric {
     /**

package/core/computed/metrics/max-potential-fid.d.ts

@@ -1,6 +1,6 @@
 export { MaxPotentialFIDComputed as MaxPotentialFID };
 declare const MaxPotentialFIDComputed: typeof MaxPotentialFID & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 declare class MaxPotentialFID extends NavigationMetric {
     /**

package/core/computed/metrics/speed-index.d.ts

@@ -1,6 +1,6 @@
 export { SpeedIndexComputed as SpeedIndex };
 declare const SpeedIndexComputed: typeof SpeedIndex & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 declare class SpeedIndex extends NavigationMetric {
     /**

package/core/computed/metrics/time-to-first-byte.d.ts

@@ -1,6 +1,6 @@
 export { TimeToFirstByteComputed as TimeToFirstByte };
 declare const TimeToFirstByteComputed: typeof TimeToFirstByte & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 declare class TimeToFirstByte extends NavigationMetric {
     /**

package/core/computed/metrics/total-blocking-time.d.ts

@@ -1,6 +1,6 @@
 export { TotalBlockingTimeComputed as TotalBlockingTime };
 declare const TotalBlockingTimeComputed: typeof TotalBlockingTime & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 /**
  * @fileoverview This audit determines Total Blocking Time.

package/core/computed/module-duplication.d.ts

@@ -1,6 +1,6 @@
 export { ModuleDuplicationComputed as ModuleDuplication };
 declare const ModuleDuplicationComputed: typeof ModuleDuplication & {
-    request: (dependencies: Pick<import("../index.js").Artifacts, "Scripts" | "SourceMaps">, context: LH.Artifacts.ComputedContext) => Promise<Map<string, {
+    request: (dependencies: Pick<import("../index.js").Artifacts, "SourceMaps" | "Scripts">, context: LH.Artifacts.ComputedContext) => Promise<Map<string, {
         scriptId: string;
         scriptUrl: string;
         resourceSize: number;

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

@@ -8,7 +8,7 @@ declare const PageDependencyGraphComputed: typeof PageDependencyGraph & {
         SourceMaps: LH.Artifacts["SourceMaps"];
         HostDPR: LH.Artifacts["HostDPR"];
         fromTrace: boolean;
-    }, context: LH.Artifacts.ComputedContext) => Promise<import("../../types/gatherer.js").default.Simulation.GraphNode>;
+    }, context: LH.Artifacts.ComputedContext) => Promise<import("../../types.js").Gatherer.Simulation.GraphNode>;
 };
 declare class PageDependencyGraph {
     /**

package/core/computed/unused-css.d.ts

@@ -8,7 +8,7 @@ declare const UnusedCSSComputed: typeof UnusedCSS & {
         Stylesheets: LH.Artifacts["Stylesheets"];
         CSSUsage: LH.Artifacts["CSSUsage"];
         devtoolsLog: LH.DevtoolsLog;
-    }, context: LH.Artifacts.ComputedContext) => Promise<import("../../types/audit.js").default.ByteEfficiencyItem[]>;
+    }, context: LH.Artifacts.ComputedContext) => Promise<import("../../types.js").Audit.ByteEfficiencyItem[]>;
 };
 /** @typedef {LH.Artifacts.CSSStyleSheetInfo & {networkRecord: LH.Artifacts.NetworkRequest, usedRules: Array<LH.Crdp.CSS.RuleUsage>}} StyleSheetInfo */
 declare class UnusedCSS {

package/core/config/agentic-browsing-config.d.ts

@@ -9,4 +9,5 @@ export namespace UIStrings {
     let agentAccessibilityGroupTitle: string;
     let agentAccessibilityGroupDescription: string;
 }
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=agentic-browsing-config.d.ts.map

package/core/config/agentic-browsing-config.js

@@ -4,14 +4,15 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
 import * as i18n from '../lib/i18n/i18n.js';
 
 const UIStrings = {
   /** Title of the Agentic Browsing category of audits. */
   agenticBrowsingCategoryTitle: 'Agentic Browsing',
   /** Description of the Agentic Browsing category. */
-  agenticBrowsingCategoryDescription: 'These checks ensure high-quality, browsable ' +
-  'websites for AI agents and validate the correctness of WebMCP integrations. ' +
+  agenticBrowsingCategoryDescription: 'These checks ensure high-quality, [browsable websites for AI agents](https://goo.gle/lighthouse-agentic-web) ' +
+  'and validate the correctness of WebMCP integrations. ' +
   'This category is still under development and subject to change.',
   /** Title of the WebMCP group of audits. */
   webmcpGroupTitle: 'WebMCP',

package/core/config/config-helpers.d.ts

@@ -91,4 +91,5 @@ export function resolveModulePath(moduleIdentifier: string, configDir?: string |
  * @return {LH.Config.Settings}
  */
 export function resolveSettings(settingsJson?: LH.SharedFlagsSettings, overrides?: LH.Flags | undefined): LH.Config.Settings;
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=config-helpers.d.ts.map

package/core/config/config-helpers.js

@@ -3,13 +3,13 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-
 import path from 'path';
 import {createRequire} from 'module';
 import url from 'url';
 
 import {isEqual} from 'lodash-es';
 
+import * as LH from '../../types/lh.js';
 import * as constants from './constants.js';
 import ConfigPlugin from './config-plugin.js';
 import {Runner} from '../runner.js';

package/core/config/config-plugin.d.ts

@@ -43,4 +43,5 @@ declare class ConfigPlugin {
      */
     static parsePlugin(pluginJson: unknown, pluginName: string): LH.Config;
 }
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=config-plugin.d.ts.map

package/core/config/config-plugin.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
 import * as i18n from '../lib/i18n/i18n.js';
 
 /**

package/core/config/config.d.ts

@@ -24,4 +24,5 @@ export function initializeConfig(gatherMode: LH.Gatherer.GatherMode, config?: LH
  * @return {string}
  */
 export function getConfigDisplayString(resolvedConfig: LH.Config.ResolvedConfig): string;
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=config.d.ts.map

package/core/config/config.js

@@ -8,6 +8,7 @@ import path from 'path';
 
 import log from 'lighthouse-logger';
 
+import * as LH from '../../types/lh.js';
 import {Runner} from '../runner.js';
 import defaultConfig from './default-config.js';
 import {nonSimulatedSettingsOverrides} from './constants.js';

package/core/config/constants.d.ts

@@ -53,5 +53,6 @@ declare const MOTOGPOWER_EMULATION_METRICS: Required<LH.SharedFlagsSettings["scr
 declare const DESKTOP_EMULATION_METRICS: Required<LH.SharedFlagsSettings["screenEmulation"]>;
 declare const MOTOG4_USERAGENT: "Mozilla/5.0 (Linux; Android 11; moto g power (2022)) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Mobile Safari/537.36";
 declare const DESKTOP_USERAGENT: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36";
+import * as LH from '../../types/lh.js';
 export {};
 //# sourceMappingURL=constants.d.ts.map

package/core/config/constants.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
 import * as Lantern from '../lib/lantern/lantern.js';
 
 const throttling = Lantern.Simulation.Constants.throttling;

package/core/config/default-config.js

@@ -100,6 +100,21 @@ const UIStrings = {
   bestPracticesBrowserCompatGroupTitle: 'Browser Compatibility',
   /** Title of the General group of the Best Practices category. Within this section are the audits that don't belong to a specific group but are of general interest. */
   bestPracticesGeneralGroupTitle: 'General',
+  /** Title of the Agentic Browsing category of audits. */
+  agenticBrowsingCategoryTitle: 'Agentic Browsing',
+  /** Description of the Agentic Browsing category. */
+  agenticBrowsingCategoryDescription: 'These checks ensure high-quality, [browsable websites for AI agents](https://goo.gle/lighthouse-agentic-web) ' +
+  'and validate the correctness of WebMCP integrations. ' +
+  'This category is still under development and subject to change.',
+  /** Title of the WebMCP group of audits. */
+  webmcpGroupTitle: 'WebMCP',
+  /** Description of the WebMCP group. */
+  webmcpGroupDescription: 'Audits validating WebMCP integration.',
+  /** Title of the Agent Accessibility group of audits. */
+  agentAccessibilityGroupTitle: 'Agent Accessibility',
+  /** Description of the Agent Accessibility group of audits. */
+  agentAccessibilityGroupDescription: 'These audits highlight best practices for improving the ' +
+  'accessibility of the website for AI agents.',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
@@ -108,6 +123,9 @@ const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
 const defaultConfig = {
   settings: constants.defaultSettings,
   artifacts: [
+    {id: 'WebMCP', gatherer: 'webmcp'},
+    {id: 'WebMcpSchemaIssues', gatherer: 'webmcp-schema'},
+    {id: 'LlmsTxt', gatherer: 'agentic/llms-txt'},
     // Artifacts which can be depended on come first.
     {id: 'DevtoolsLog', gatherer: 'devtools-log'},
     {id: 'Trace', gatherer: 'trace'},
@@ -279,6 +297,11 @@ const defaultConfig = {
     'seo/hreflang',
     'seo/canonical',
     'seo/manual/structured-data',
+    'agentic/agent-accessibility-tree',
+    'webmcp-registered-tools',
+    'webmcp-form-coverage',
+    'webmcp-schema-validity',
+    'agentic/llms-txt',
     'bf-cache',
     'insights/cache-insight',
     'insights/cls-culprits-insight',
@@ -366,6 +389,14 @@ const defaultConfig = {
     'best-practices-general': {
       title: str_(UIStrings.bestPracticesGeneralGroupTitle),
     },
+    'webmcp': {
+      title: str_(UIStrings.webmcpGroupTitle),
+      description: str_(UIStrings.webmcpGroupDescription),
+    },
+    'agent-accessibility': {
+      title: str_(UIStrings.agentAccessibilityGroupTitle),
+      description: str_(UIStrings.agentAccessibilityGroupDescription),
+    },
     // Group for audits that should not be displayed.
     'hidden': {title: ''},
   },
@@ -601,6 +632,20 @@ const defaultConfig = {
         {id: 'structured-data', weight: 0},
       ],
     },
+    'agentic-browsing': {
+      title: str_(UIStrings.agenticBrowsingCategoryTitle),
+      description: str_(UIStrings.agenticBrowsingCategoryDescription),
+      supportedModes: ['navigation', 'snapshot'],
+      categoryScoreDisplayMode: 'fraction',
+      auditRefs: [
+        {id: 'agent-accessibility-tree', weight: 1, group: 'agent-accessibility'},
+        {id: 'webmcp-form-coverage', weight: 1, group: 'webmcp'},
+        {id: 'webmcp-registered-tools', weight: 1, group: 'webmcp'},
+        {id: 'webmcp-schema-validity', weight: 1, group: 'webmcp'},
+        {id: 'cumulative-layout-shift', weight: 1, acronym: 'CLS'},
+        {id: 'llms-txt', weight: 1, group: 'agent-accessibility'},
+      ],
+    },
   },
 };
 

package/core/config/experimental-config.d.ts

@@ -1,13 +1,5 @@
 export default config;
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * @fileoverview Config for new audits that aren't quite ready for
- * being enabled by default.
- */
 /** @type {LH.Config} */
 declare const config: LH.Config;
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=experimental-config.d.ts.map

package/core/config/experimental-config.js

@@ -9,6 +9,8 @@
  * being enabled by default.
  */
 
+import * as LH from '../../types/lh.js';
+
 /** @type {LH.Config} */
 const config = {
   extends: 'lighthouse:default',

package/core/config/filters.d.ts

@@ -72,4 +72,5 @@ export function filterCategoriesByExplicitFilters(categories: LH.Config.Resolved
  * @return {LH.Config.ResolvedConfig['categories']}
  */
 export function filterCategoriesByGatherMode(categories: LH.Config.ResolvedConfig["categories"], mode: LH.Gatherer.GatherMode): LH.Config.ResolvedConfig["categories"];
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=filters.d.ts.map

package/core/config/filters.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
 import {Audit} from '../audits/audit.js';
 
 /** @type {Record<keyof LH.BaseArtifacts, string>} */

package/core/config/full-config.d.ts

@@ -1,9 +1,5 @@
 export default fullConfig;
-/**
- * @license
- * Copyright 2017 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
 /** @type {LH.Config} */
 declare const fullConfig: LH.Config;
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=full-config.d.ts.map

package/core/config/full-config.js

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
+
 /** @type {LH.Config} */
 const fullConfig = {
   extends: 'lighthouse:default',

package/core/config/lr-desktop-config.d.ts

@@ -1,4 +1,5 @@
 export default config;
 /** @type {LH.Config} */
 declare const config: LH.Config;
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=lr-desktop-config.d.ts.map

package/core/config/lr-desktop-config.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
 import * as constants from './constants.js';
 
 /** @type {LH.Config} */

package/core/config/lr-mobile-config.d.ts

@@ -1,9 +1,5 @@
 export default config;
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
 /** @type {LH.Config} */
 declare const config: LH.Config;
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=lr-mobile-config.d.ts.map

package/core/config/lr-mobile-config.js

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
+
 /** @type {LH.Config} */
 const config = {
   extends: 'lighthouse:default',

package/core/config/perf-config.d.ts

@@ -1,9 +1,5 @@
 export default perfConfig;
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
 /** @type {LH.Config} */
 declare const perfConfig: LH.Config;
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=perf-config.d.ts.map

package/core/config/perf-config.js

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
+
 /** @type {LH.Config} */
 const perfConfig = {
   extends: 'lighthouse:default',

package/core/config/validation.d.ts

@@ -58,4 +58,5 @@ export function throwInvalidDependencyOrder(artifactId: string, dependencyKey: s
  * @return {never}
  */
 export function throwInvalidArtifactDependency(artifactId: string, dependencyKey: string): never;
+import * as LH from '../../types/lh.js';
 //# sourceMappingURL=validation.d.ts.map

package/core/config/validation.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as LH from '../../types/lh.js';
 import {Audit} from '../audits/audit.js';
 import BaseGatherer from '../gather/base-gatherer.js';
 import * as i18n from '../lib/i18n/i18n.js';

package/core/gather/driver/execution-context.d.ts

@@ -102,6 +102,29 @@ export class ExecutionContext {
         args: T;
         deps?: Array<Function | string>;
     }): Promise<void>;
+    /**
+     * Call a function on the given object.
+     * Returns a promise that resolves on a value of `mainFn`'s return type.
+     * @template {unknown[]} T, R
+     * @param {((thisArg: any, ...args: T) => R)} mainFn The main function to call.
+     * @param {{args: T, objectId: string, deps?: Array<Function|string>}} options `args` should
+     *   match the args of `mainFn`, and can be any serializable value. `deps` are functions that must be
+     *   defined for `mainFn` to work.
+     * @return {Promise<Awaited<R>>}
+     */
+    evaluateOnObject<T extends unknown[], R>(mainFn: ((thisArg: any, ...args: T) => R), options: {
+        args: T;
+        objectId: string;
+        deps?: Array<Function | string>;
+    }): Promise<Awaited<R>>;
+    /**
+     * @param {string} functionDeclaration
+     * @param {{objectId: string}} options
+     * @return {Promise<*>}
+     */
+    _callFunctionOn(functionDeclaration: string, options: {
+        objectId: string;
+    }): Promise<any>;
     /**
      * Cache native functions/objects inside window so we are sure polyfills do not overwrite the
      * native implementations when the page loads.

package/core/gather/driver/execution-context.js

@@ -223,6 +223,7 @@ class ExecutionContext {
 
     const expression = `(() => {
       ${ExecutionContext._cachedNativesPreamble};
+      ${pageFunctions.esbuildFunctionWrapperString}
       ${depsSerialized};
       (${mainFn})(${argsSerialized});
     })()
@@ -231,6 +232,87 @@ class ExecutionContext {
     await this._session.sendCommand('Page.addScriptToEvaluateOnNewDocument', {source: expression});
   }
 
+  /**
+   * Call a function on the given object.
+   * Returns a promise that resolves on a value of `mainFn`'s return type.
+   * @template {unknown[]} T, R
+   * @param {((thisArg: any, ...args: T) => R)} mainFn The main function to call.
+   * @param {{args: T, objectId: string, deps?: Array<Function|string>}} options `args` should
+   *   match the args of `mainFn`, and can be any serializable value. `deps` are functions that must be
+   *   defined for `mainFn` to work.
+   * @return {Promise<Awaited<R>>}
+   */
+  evaluateOnObject(mainFn, options) {
+    const argsSerialized = ExecutionContext.serializeArguments(options.args);
+    const depsSerialized = ExecutionContext.serializeDeps(options.deps);
+
+    const argsString = argsSerialized ? `this, ${argsSerialized}` : 'this';
+    const functionDeclaration = `function() {
+      ${depsSerialized}
+      return (${mainFn})(${argsString});
+    }`;
+    return this._callFunctionOn(functionDeclaration, options);
+  }
+
+  /**
+   * @param {string} functionDeclaration
+   * @param {{objectId: string}} options
+   * @return {Promise<*>}
+   */
+  async _callFunctionOn(functionDeclaration, options) {
+    const timeout = this._session.hasNextProtocolTimeout() ?
+      this._session.getNextProtocolTimeout() :
+      60000;
+
+    const evaluationParams = {
+      functionDeclaration: `function wrapInNativePromise() {
+        ${ExecutionContext._cachedNativesPreamble};
+        ${pageFunctions.esbuildFunctionWrapperString}
+        const self = this;
+        const args = arguments;
+        return new Promise(function (resolve) {
+          return Promise.resolve()
+            .then(_ => (${functionDeclaration}).apply(self, args))
+            .catch(${pageFunctions.wrapRuntimeEvalErrorInBrowser})
+            .then(resolve);
+        });
+      }
+      //# sourceURL=_lighthouse-eval.js
+      `,
+      objectId: options.objectId,
+      returnByValue: true,
+      awaitPromise: true,
+      timeout,
+    };
+
+    this._session.setNextProtocolTimeout(timeout);
+    const response = await this._session.sendCommand('Runtime.callFunctionOn', evaluationParams);
+
+    const ex = response.exceptionDetails;
+    if (ex) {
+      const elidedExpression = functionDeclaration.replace(/\s+/g, ' ').substring(0, 100);
+      const messageLines = [
+        'Runtime.callFunctionOn exception',
+        `Expression: ${elidedExpression}\n---- (elided)`,
+        !ex.stackTrace ? `Parse error at: ${ex.lineNumber + 1}:${ex.columnNumber + 1}` : null,
+        ex.exception?.description || ex.text,
+      ].filter(Boolean);
+      const evaluationError = new Error(messageLines.join('\n'));
+      return Promise.reject(evaluationError);
+    }
+
+    if (response.result === undefined) {
+      return Promise.reject(
+        new Error('Runtime.callFunctionOn response did not contain a "result" object'));
+    }
+    const value = response.result.value;
+    if (value?.__failedInBrowser) {
+      return Promise.reject(Object.assign(new Error(), value));
+    } else {
+      return value;
+    }
+  }
+
   /**
    * Cache native functions/objects inside window so we are sure polyfills do not overwrite the
    * native implementations when the page loads.
@@ -279,7 +361,10 @@ class ExecutionContext {
    * @return {string}
    */
   static serializeDeps(deps) {
-    deps = [pageFunctions.esbuildFunctionWrapperString, ...deps || []];
+    if (!deps) {
+      return '';
+    }
+
     return deps.map(dep => {
       if (typeof dep === 'function') {
         // esbuild will change the actual function name (ie. function actualName() {})

package/core/gather/driver/storage.js

@@ -7,6 +7,7 @@
 import log from 'lighthouse-logger';
 
 import * as i18n from '../../lib/i18n/i18n.js';
+import {Sentry} from '../../lib/sentry.js';
 
 /* eslint-disable max-len */
 const UIStrings = {
@@ -81,6 +82,18 @@ async function getImportantStorageWarning(session, url) {
   const usageData = await session.sendCommand('Storage.getUsageAndQuota', {
     origin: url,
   });
+
+  // According to the types, this should never happen. But we've gotten an error
+  // report that it does.
+  // https://github.com/GoogleChrome/lighthouse/issues/17011
+  if (!usageData || !usageData.usageBreakdown) {
+    const err = new Error(`missing usageData: ${JSON.stringify(usageData)}`);
+    Sentry.captureException(err, {
+      level: 'error',
+    });
+    return;
+  }
+
   /** @type {Record<string, string>} */
   const storageTypeNames = {
     local_storage: 'Local Storage',

package/core/gather/driver.d.ts

@@ -13,7 +13,7 @@ export class Driver implements LH.Gatherer.Driver {
     _executionContext: ExecutionContext | undefined;
     /** @type {Fetcher|undefined} */
     _fetcher: Fetcher | undefined;
-    defaultSession: import("../../types/gatherer.js").default.ProtocolSession;
+    defaultSession: import("../../types.js").Gatherer.ProtocolSession;
     /** @return {LH.Gatherer.Driver['executionContext']} */
     get executionContext(): LH.Gatherer.Driver["executionContext"];
     get fetcher(): any;

package/core/gather/gatherers/accessibility.js

@@ -84,6 +84,7 @@ async function runA11yChecks() {
       'table-fake-caption': {enabled: true},
       'target-size': {enabled: true},
       'td-has-header': {enabled: true},
+      'aria-tab-name': {enabled: false}, // TODO: consider adding.
     },
   });
 

package/core/gather/gatherers/trace-elements.d.ts

@@ -67,9 +67,12 @@ declare class TraceElements extends BaseGatherer {
     stopInstrumentation(context: LH.Gatherer.Context): Promise<void>;
     /**
      * @param {LH.Gatherer.ProtocolSession} session
+     * @param {LH.Gatherer.Driver['executionContext']} executionContext
      * @param {number} backendNodeId
      */
-    getNodeDetails(session: LH.Gatherer.ProtocolSession, backendNodeId: number): Promise<import("devtools-protocol").Protocol.Runtime.CallFunctionOnResponse | null>;
+    getNodeDetails(session: LH.Gatherer.ProtocolSession, executionContext: LH.Gatherer.Driver["executionContext"], backendNodeId: number): Promise<{
+        node: any;
+    } | null | undefined>;
     /**
      * @param {LH.Gatherer.Context<'Trace'|'SourceMaps'>} context
      * @return {Promise<LH.Artifacts.TraceElement[]>}