lighthouse 13.0.3 → 13.2.0

package/core/lib/deprecations-strings.js

@@ -1,6 +1,6 @@
 // auto-generated by build/build-cdt-strings.js
 /* eslint-disable */
-// Copyright 2025 The Chromium Authors
+// Copyright 2026 The Chromium Authors
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
@@ -8,6 +8,10 @@
 
 
 export const UIStrings = {
+  /**
+   * @description This warning occurs when the website uses Attribution Reporting.
+   */
+  AttributionReporting: "Attribution Reporting is deprecated and will be removed. See https://goo.gle/ps-status for details.",
   /**
    * @description We show this warning when 1) an 'authorization' header is attached to the request by scripts, 2) there is no 'authorization' in the 'access-control-allow-headers' header in the response, and 3) there is a wildcard symbol ('*') in the 'access-control-allow-header' header in the response. This is allowed now, but we're planning to reject such responses and require responses to have an 'access-control-allow-headers' containing 'authorization'.
    */
@@ -28,10 +32,6 @@ export const UIStrings = {
    * @description This warning occurs when the website attempts to invoke the deprecated `chrome.loadTimes().wasAlternateProtocolAvailable` API.
    */
   ChromeLoadTimesWasAlternateProtocolAvailable: "`chrome.loadTimes()` is deprecated, instead use standardized API: `nextHopProtocol` in Navigation Timing 2.",
-  /**
-   * @description This warning occurs when the browser attempts to store a cookie containing a banned character. Rather than the cookie string being truncated at the banned character, the entire cookie will be rejected now.
-   */
-  CookieWithTruncatingChar: "Cookies containing a `(0|r|n)` character will be rejected instead of truncated.",
   /**
    * @description This warning occurs when a frame accesses another frame's data after having set `document.domain` without having set the `Origin-Agent-Cluster` http header. This is a companion warning to `documentDomainSettingWithoutOriginAgentClusterHeader`, where that warning occurs when `document.domain` is set, and this warning occurs when an access has been made, based on that previous `document.domain` setting.
    */
@@ -56,6 +56,22 @@ export const UIStrings = {
    * @description Warning displayed to developers when a data: URL is assigned to SVGUseElement to let them know that the support is deprecated.
    */
   DataUrlInSvgUse: "Support for data: URLs in SVGUseElement is deprecated and it will be removed in the future.",
+  /**
+   * @description Warning displayed to developers when document.createEvent() is called with 'KeyboardEvents', which is a non-standard event interface that will be removed.
+   */
+  DocumentCreateEventKeyboardEvents: "document.createEvent('KeyboardEvents') is deprecated and will be removed. Use `new KeyboardEvent()` instead.",
+  /**
+   * @description Warning displayed to developers when document.createEvent() is called with 'TransitionEvent', which is a non-standard event interface that will be removed.
+   */
+  DocumentCreateEventTransitionEvent: "document.createEvent('TransitionEvent') is deprecated and will be removed. Use `new TransitionEvent()` instead.",
+  /**
+   * @description Translation is not needed, this will never be exposed in production code.
+   */
+  ExampleBrowserProcessDeprecation: "This is an example for showing the code required for a browser process reported deprecation.",
+  /**
+   * @description A deprecation warning shown in the DevTools Issues tab. It's shown when one of the Protected Audience APIs like `navigator.joinAdInterestGroup`, `navigator.getInterestGroupAdAuctionData` or `navigator.runAdAuction` are called.
+   */
+  Fledge: "The Protected Audience API is deprecated and will be removed in a future release.",
   /**
    * @description Warning displayed to developers when the Geolocation API is used from an insecure origin (one that isn't localhost or doesn't use HTTPS) to notify them that this use is no longer supported.
    */
@@ -89,17 +105,37 @@ export const UIStrings = {
    */
   IntlV8BreakIterator: "`Intl.v8BreakIterator` is deprecated. Please use `Intl.Segmenter` instead.",
   /**
-   * @description This warning occurs when a stylesheet loaded from a local file directive does not end in the file type `.css`.
+   * @description Warning for using deprecated 'inputQuota' attribute.
    */
-  LocalCSSFileExtensionRejected: "CSS cannot be loaded from `file:` URLs unless they end in a `.css` file extension.",
+  LanguageModel_InputQuota: "LanguageModel.inputQuota is deprecated. Please use LanguageModel.contextWindow instead. This alias is only available in extensions.",
   /**
-   * @description This is a deprecation warning to developers that occurs when the script attempts to use the Media Source Extensions API in a way that is no longer supported by the specification for the API. The usage that is problematic is when the script calls the `SourceBuffer.abort()` method at a time when there is still processing happening in response to a previous `SourceBuffer.remove()` call for the same SourceBuffer object. More precisely, we show this warning to developers when script calls the SourceBuffer abort() method while the asynchronous processing of a remove() call on that SourceBuffer is not yet complete. Early versions of the Media Source Extensions specification allowed such aborts, but standardization of the specification resulted in disallowing the aborts. The script should instead wait for the asynchronous remove() operation to complete, which is observable by listening for the associated 'updateend' event from the SourceBuffer. A note is also included in the warning, describing when abort() is meaningful and allowed by the specification for purposes other than interrupting a remove() operation's asynchronous steps. Those supported purposes include using abort() to interrupt processing that may still be happening in response to a previous appendBuffer() call on that SourceBuffer, or using abort() to clear the internal of any unprocessed data remaining from previous appendBuffer() calls. See https://www.w3.org/TR/media-source-2/#dom-sourcebuffer-abort for the currently specified behavior, which would throw an exception once the deprecated removal abort is no longer supported. See https://github.com/w3c/media-source/issues/19 for the discussion that led to the specification change.
+   * @description Warning for using deprecated 'inputUsage' attribute.
    */
-  MediaSourceAbortRemove: "Using `SourceBuffer.abort()` to abort `remove()`'s asynchronous range removal is deprecated due to specification change. Support will be removed in the future. You should listen to the `updateend` event instead. `abort()` is intended to only abort an asynchronous media append or reset parser state.",
+  LanguageModel_InputUsage: "LanguageModel.inputUsage is deprecated. Please use LanguageModel.contextUsage instead. This alias is only available in extensions.",
   /**
-   * @description This is a deprecation warning to developers that occurs when the script attempts to use the Media Source Extensions API in a way that is no longer supported by the specification for the API. The usage that is problematic is when the script sets the duration attribute of a MediaSource object too low. The duration attribute of a MediaSource must be longer than the actual duration of any media (audio or video) already in the MediaSource. When set too low, the MediaSource must remove audio and video content that is beyond the time indicated by the new duration. Content removal that is caused by setting the duration attribute too low is no longer allowed by the specification. The message describes the minimum allowable duration value as the 'highest presentation timestamp of any buffered coded frames' as a more precise way of describing the duration of content already in the MediaSource: 'coded frames' are the specification's way of describing compressed audio frames or compressed video frames, and they each have a 'presentation timestamp' that describes precisely when that frame's playback occurs in the overall media presentation. Early versions of the Media Source Extensions specification allowed this to happen, but standardization of the specification resulted in disallowing this behavior. The underlying issue leading to this specification change was that setting the duration attribute should be synchronous, but setting it lower than the timestamp of something currently buffered would cause confusing removal of media between that new duration and the previous, larger, duration. The script should instead explicitly remove that range of media first, before lowering the duration. See https://www.w3.org/TR/media-source-2/#dom-mediasource-duration and https://www.w3.org/TR/media-source-2/#dom-mediasource-duration for the currently specified behavior, which would throw an exception once support is removed for deprecated implicit asynchronous range removal when duration is truncated. See both https://github.com/w3c/media-source/issues/20 and https://github.com/w3c/media-source/issues/26 for the discussion that led to the specification change.
+   * @description Warning for using deprecated 'measureInputUsage' method.
    */
-  MediaSourceDurationTruncatingBuffered: "Setting `MediaSource.duration` below the highest presentation timestamp of any buffered coded frames is deprecated due to specification change. Support for implicit removal of truncated buffered media will be removed in the future. You should instead perform explicit `remove(newDuration, oldDuration)` on all `sourceBuffers`, where `newDuration < oldDuration`.",
+  LanguageModel_MeasureInputUsage: "LanguageModel.measureInputUsage() is deprecated. Please use LanguageModel.measureContextUsage() instead. This alias is only available in extensions.",
+  /**
+   * @description Warning for using deprecated 'onquotaoverflow' event handler.
+   */
+  LanguageModel_OnQuotaOverflow: "LanguageModel.onquotaoverflow is deprecated. Please use LanguageModel.oncontextoverflow instead. The LanguageModel.onquotaoverflow alias is only available in extensions.",
+  /**
+   * @description Warning message for web developers when they call the deprecated LanguageModel.params() method.
+   */
+  LanguageModelParams: "LanguageModel.params() is deprecated and now only available in extension contexts. The topK and temperature related fields within its result are also deprecated.",
+  /**
+   * @description Warning message for web developers when they use the deprecated 'temperature' option in LanguageModel.create() or access the .temperature attribute.
+   */
+  LanguageModelTemperature: "The 'temperature' parameter/attribute for LanguageModel is deprecated. It is only functional within extensions and may be removed in the future.",
+  /**
+   * @description Warning message for web developers when they use the deprecated 'topK' option in LanguageModel.create() or access the .topK attribute.
+   */
+  LanguageModelTopK: "The 'topK' parameter/attribute for LanguageModel is deprecated. It is only functional within extensions and may be removed in the future.",
+  /**
+   * @description This warning occurs when a stylesheet loaded from a local file directive does not end in the file type `.css`.
+   */
+  LocalCSSFileExtensionRejected: "CSS cannot be loaded from `file:` URLs unless they end in a `.css` file extension.",
   /**
    * @description This warning occurs when the browser requests Web MIDI access as sysex (system exclusive messages) can be allowed via prompt even if the browser did not specifically request it.
    */
@@ -176,14 +212,14 @@ export const UIStrings = {
    * @description Standard message when one web API is deprecated in favor of another.
    */
   PrefixedVideoSupportsFullscreen: "HTMLVideoElement.webkitSupportsFullscreen is deprecated. Please use Document.fullscreenEnabled instead.",
-  /**
-   * @description Warning displayed to developers that the API `chrome.privacy.websites.privacySandboxEnabled` is being deprecated in favour of three new more granular APIs: topicsEnabled, FledgeEnabled and adMeasurementEnabled. The `privacySandboxEnabled` API allowed extensions to control the homologous Chrome Setting. The existing Chrome Setting for Privacy Sandbox is also going away in favor of more granular settings that are matched by the new extensions APIs- topicsEnabled, FledgeEnabled and adMeasurementEnabled.
-   */
-  PrivacySandboxExtensionsAPI: "We're deprecating the API `chrome.privacy.websites.privacySandboxEnabled`, though it will remain active for backward compatibility until release M113. Instead, please use `chrome.privacy.websites.topicsEnabled`, `chrome.privacy.websites.fledgeEnabled` and `chrome.privacy.websites.adMeasurementEnabled`. See https://developer.chrome.com/docs/extensions/reference/privacy/#property-websites-privacySandboxEnabled.",
   /**
    * @description Standard message when one web API is deprecated in favor of another.
    */
   RangeExpand: "Range.expand() is deprecated. Please use Selection.modify() instead.",
+  /**
+   * @description A deprecation warning shown in the DevTools Issues tab. It's shown when the Storage Access API is automatically granted by Related Website Sets. The placeholder will always be the string `Related Website Sets`.
+   */
+  RelatedWebsiteSets: "`Related Website Sets` is deprecated and will be removed. See https://privacysandbox.com/news/update-on-plans-for-privacy-sandbox-technologies/ for more details.",
   /**
    * @description This warning occurs when a subresource loaded by a page has a URL with an authority portion. These are disallowed.
    */
@@ -208,10 +244,22 @@ export const UIStrings = {
    * @description A deprecation warning shown in the DevTools Issues tab. The placeholder is always the noun 'SharedArrayBuffer' which refers to a JavaScript construct.
    */
   SharedArrayBufferConstructedWithoutIsolation: "`SharedArrayBuffer` will require cross-origin isolation. See https://developer.chrome.com/blog/enabling-shared-array-buffer/ for more details.",
+  /**
+   * @description A deprecation warning shown in the DevTools Issues tab. It's shown when one of the Shared Storage APIs like `sharedStorage.set()`, `sharedStorage.worklet.addModule()`, `sharedStorage.selectURL()`, etc., along with `<img sharedstoragewritable>`, `<iframe sharedstoragewritable>`, or `fetch(url, {sharedStorageWritable: true})` are used.
+   */
+  SharedStorage: "The Shared Storage API is deprecated and will be removed in a future release.",
+  /**
+   * @description A deprecation warning shown in the DevTools Issues tab. It's shown when the `document.requestStorageAccessFor` API is called. The placeholder will always be the string `document.requestStorageAccessFor`.
+   */
+  StorageAccessAPI_requestStorageAccessFor_Method: "`document.requestStorageAccessFor` is deprecated and will be removed. See https://privacysandbox.com/news/update-on-plans-for-privacy-sandbox-technologies/ for more details.",
   /**
    * @description A deprecation warning shown in the DevTools Issues tab. It's shown when the speech synthesis API is called before the page receives a user activation.
    */
   TextToSpeech_DisallowedByAutoplay: "`speechSynthesis.speak()` without user activation is deprecated and will be removed.",
+  /**
+   * @description A deprecation warning shown in the DevTools Issues tab. It's shown when one of the Topics APIs like `document.browsingTopics()`, `<img browsingtopics>`, `<iframe browsingtopics>`, or `fetch(url, {browsingTopics: true})` are used.
+   */
+  Topics: "The Topics API is deprecated and will be removed in a future release.",
   /**
    * @description A deprecation warning shown in the DevTools Issues tab. It's shown when a listener for the `unload` event is added.
    */
@@ -220,6 +268,10 @@ export const UIStrings = {
    * @description A deprecation warning shown in the DevTools Issues tab. The placeholder is always the noun 'SharedArrayBuffer' which refers to a JavaScript construct. 'Extensions' refers to Chrome extensions. The warning is shown when Chrome Extensions attempt to use 'SharedArrayBuffer's under insecure circumstances.
    */
   V8SharedArrayBufferConstructedInExtensionWithoutIsolation: "Extensions should opt into cross-origin isolation to continue using `SharedArrayBuffer`. See https://developer.chrome.com/docs/extensions/mv3/cross-origin-isolation/.",
+  /**
+   * @description This warning occurs when the deprecated `BluetoothRemoteGATTCharacteristic.writeValue()` method is used. Developers should use `writeValueWithResponse()` or `writeValueWithoutResponse()` instead.
+   */
+  WebBluetoothRemoteCharacteristicWriteValue: "`BluetoothRemoteGATTCharacteristic.writeValue()` is deprecated. Use `writeValueWithResponse()` or `writeValueWithoutResponse()` instead.",
   /**
    * @description Warning displayed to developers that they are using `XMLHttpRequest` API in a way that they expect an unsupported character encoding `UTF-16` could be used in the server reply.
    */
@@ -228,6 +280,10 @@ export const UIStrings = {
    * @description Warning displayed to developers. It is shown when the `XMLHttpRequest` API is used in a way that it slows down the page load of the next page. The `main thread` refers to an operating systems thread used to run most of the processing of HTML documents, so please use a consistent wording.
    */
   XMLHttpRequestSynchronousInNonWorkerOutsideBeforeUnload: "Synchronous `XMLHttpRequest` on the main thread is deprecated because of its detrimental effects to the end user's experience. For more help, check https://xhr.spec.whatwg.org/.",
+  /**
+   * @description Warning displayed to developers that they are using either the XSLTProcessor API, or XSLT processing instructions, both of which have been deprecated and are scheduled to be removed.
+   */
+  XSLT: "XSLTProcessor and XSLT Processing Instructions have been deprecated by all browsers. These features will be removed from this browser soon.",
 };
 
 
@@ -235,6 +291,9 @@ export const UIStrings = {
 
 
 export const DEPRECATIONS_METADATA = {
+  "AttributionReporting": {
+    "chromeStatusFeature": 6320639375966208
+  },
   "AuthorizationCoveredByWildcard": {
     "milestone": 97
   },
@@ -256,9 +315,6 @@ export const DEPRECATIONS_METADATA = {
   "ChromeLoadTimesWasAlternateProtocolAvailable": {
     "chromeStatusFeature": 5637885046816768
   },
-  "CookieWithTruncatingChar": {
-    "milestone": 103
-  },
   "CrossOriginAccessBasedOnDocumentDomain": {
     "milestone": 115
   },
@@ -266,6 +322,14 @@ export const DEPRECATIONS_METADATA = {
     "chromeStatusFeature": 5128825141198848,
     "milestone": 119
   },
+  "DocumentCreateEventKeyboardEvents": {
+    "chromeStatusFeature": 5095987863486464,
+    "milestone": 151
+  },
+  "DocumentCreateEventTransitionEvent": {
+    "chromeStatusFeature": 5095987863486464,
+    "milestone": 151
+  },
   "IdentityInCanMakePaymentEvent": {
     "chromeStatusFeature": 5190978431352832
   },
@@ -273,14 +337,29 @@ export const DEPRECATIONS_METADATA = {
     "chromeStatusFeature": 5436853517811712,
     "milestone": 92
   },
-  "LocalCSSFileExtensionRejected": {
-    "milestone": 64
+  "LanguageModelParams": {
+    "chromeStatusFeature": 5134603979063296
+  },
+  "LanguageModelTemperature": {
+    "chromeStatusFeature": 5134603979063296
+  },
+  "LanguageModelTopK": {
+    "chromeStatusFeature": 5134603979063296
+  },
+  "LanguageModel_InputQuota": {
+    "chromeStatusFeature": 5134603979063296
+  },
+  "LanguageModel_InputUsage": {
+    "chromeStatusFeature": 5134603979063296
+  },
+  "LanguageModel_MeasureInputUsage": {
+    "chromeStatusFeature": 5134603979063296
   },
-  "MediaSourceAbortRemove": {
-    "chromeStatusFeature": 6107495151960064
+  "LanguageModel_OnQuotaOverflow": {
+    "chromeStatusFeature": 5134603979063296
   },
-  "MediaSourceDurationTruncatingBuffered": {
-    "chromeStatusFeature": 6107495151960064
+  "LocalCSSFileExtensionRejected": {
+    "milestone": 64
   },
   "NoSysexWebMIDIWithoutPermission": {
     "chromeStatusFeature": 5138066234671104,
@@ -322,6 +401,9 @@ export const DEPRECATIONS_METADATA = {
     "chromeStatusFeature": 4631626228695040,
     "milestone": 117
   },
+  "RelatedWebsiteSets": {
+    "chromeStatusFeature": 5194473869017088
+  },
   "RequestedSubresourceWithEmbeddedCredentials": {
     "chromeStatusFeature": 5669008342777856
   },
@@ -332,6 +414,12 @@ export const DEPRECATIONS_METADATA = {
   "SharedArrayBufferConstructedWithoutIsolation": {
     "milestone": 106
   },
+  "SharedStorage": {
+    "chromeStatusFeature": 5076349064708096
+  },
+  "StorageAccessAPI_requestStorageAccessFor_Method": {
+    "chromeStatusFeature": 5162221567082496
+  },
   "TextToSpeech_DisallowedByAutoplay": {
     "chromeStatusFeature": 5687444770914304,
     "milestone": 71
@@ -342,7 +430,14 @@ export const DEPRECATIONS_METADATA = {
   "V8SharedArrayBufferConstructedInExtensionWithoutIsolation": {
     "milestone": 96
   },
+  "WebBluetoothRemoteCharacteristicWriteValue": {
+    "chromeStatusFeature": 5088568590598144
+  },
   "XHRJSONEncodingDetection": {
     "milestone": 93
+  },
+  "XSLT": {
+    "chromeStatusFeature": 4709671889534976,
+    "milestone": 143
   }
 };

package/core/lib/navigation-error.js

@@ -130,8 +130,11 @@ function getNonHtmlError(finalRecord) {
  */
 function getPageLoadError(navigationError, context) {
   const {url, networkRecords} = context;
-  /** @type {LH.Artifacts.NetworkRequest|undefined} */
-  let mainRecord = Lantern.Core.NetworkAnalyzer.findResourceForUrl(networkRecords, url);
+  const mainRecordLantern = Lantern.Core.NetworkAnalyzer.findResourceForUrl(
+    networkRecords,
+    url
+  );
+  let mainRecord = mainRecordLantern;
 
   // If the url doesn't give us a network request, it's possible we landed on a chrome-error:// page
   // In this case, just get the first document request.

package/core/lib/network-recorder.js

@@ -253,7 +253,8 @@ class NetworkRecorder extends RequestEventEmitter {
       return record.redirectSource;
     }
 
-    const initiatorURL = Lantern.Graph.PageDependencyGraph.getNetworkInitiators(record)[0];
+    const lanternReq = NetworkRequest.asLanternNetworkRequest(record);
+    const initiatorURL = Lantern.Graph.PageDependencyGraph.getNetworkInitiators(lanternReq)[0];
     let candidates = recordsByURL.get(initiatorURL) || [];
     // The (valid) initiator must come before the initiated request.
     candidates = candidates.filter(c => {

package/core/lib/page-functions.d.ts

@@ -88,10 +88,10 @@ declare namespace getOuterHTMLSnippet {
  */
 declare function computeBenchmarkIndex(): number;
 /**
- * @param {Element|ShadowRoot} element
- * @return {LH.Artifacts.NodeDetails}
+ * @param {Node|ShadowRoot} node
+ * @return {LH.Artifacts.NodeDetails | null}
  */
-declare function getNodeDetails(element: Element | ShadowRoot): LH.Artifacts.NodeDetails;
+declare function getNodeDetails(node: Node | ShadowRoot): LH.Artifacts.NodeDetails | null;
 declare namespace getNodeDetails {
     function toString(): string;
 }

package/core/lib/page-functions.js

@@ -450,16 +450,23 @@ function wrapRequestIdleCallback(cpuSlowdownMultiplier) {
 }
 
 /**
- * @param {Element|ShadowRoot} element
- * @return {LH.Artifacts.NodeDetails}
+ * @param {Node|ShadowRoot} node
+ * @return {LH.Artifacts.NodeDetails | null}
  */
-function getNodeDetails(element) {
+function getNodeDetails(node) {
   // This bookkeeping is for the FullPageScreenshot gatherer.
   if (!window.__lighthouseNodesDontTouchOrAllVarianceGoesAway) {
     window.__lighthouseNodesDontTouchOrAllVarianceGoesAway = new Map();
   }
 
-  element = element instanceof ShadowRoot ? element.host : element;
+  let elem = node.nodeType === Node.ELEMENT_NODE ? node : node.parentElement;
+  if (!elem && node instanceof ShadowRoot) {
+    elem = node.host;
+  }
+
+  if (!elem) return null;
+
+  const element = /** @type {Element} */ (elem);
   const selector = getNodeSelector(element);
 
   // Create an id that will be unique across all execution contexts.

package/core/lib/tracehouse/trace-processor.d.ts

@@ -196,9 +196,10 @@ export class TraceProcessor {
      *
      * @param {LH.TraceEvent[]} events
      * @param {LH.TraceEvent} timeOriginEvent
+     * @param {string|undefined} mainFrameId
      * @return {{lcp: LCPEvent | undefined, invalidated: boolean}}
      */
-    static computeValidLCPAllFrames(events: LH.TraceEvent[], timeOriginEvent: LH.TraceEvent): {
+    static computeValidLCPAllFrames(events: LH.TraceEvent[], timeOriginEvent: LH.TraceEvent, mainFrameId: string | undefined): {
         lcp: LCPEvent | undefined;
         invalidated: boolean;
     };
@@ -217,7 +218,7 @@ export class TraceProcessor {
      * @param {LH.Trace} trace
      * @param {{timeOriginDeterminationMethod?: TimeOriginDeterminationMethod}} [options]
      * @return {LH.Artifacts.ProcessedTrace}
-    */
+     */
     static processTrace(trace: LH.Trace, options?: {
         timeOriginDeterminationMethod?: TimeOriginDeterminationMethod;
     }): LH.Artifacts.ProcessedTrace;
@@ -226,7 +227,7 @@ export class TraceProcessor {
      * origin in addition to the standard microsecond monotonic timestamps.
      * @param {LH.Artifacts.ProcessedTrace} processedTrace
      * @return {LH.Artifacts.ProcessedNavigation}
-    */
+     */
     static processNavigation(processedTrace: LH.Artifacts.ProcessedTrace): LH.Artifacts.ProcessedNavigation;
     /**
      * Computes the last observable timestamp in a set of trace events.
@@ -272,7 +273,7 @@ export class TraceProcessor {
      * in addition to the standard microsecond monotonic timestamps.
      * @param {Array<LH.TraceEvent>} frameEvents
      * @param {{timeOriginEvt: LH.TraceEvent}} options
-    */
+     */
     static computeNavigationTimingsForFrame(frameEvents: Array<LH.TraceEvent>, options: {
         timeOriginEvt: LH.TraceEvent;
     }): {

package/core/lib/tracehouse/trace-processor.js

@@ -349,7 +349,7 @@ class TraceProcessor {
 
     const ret = this.getMainThreadTopLevelEventDurations(events, startTime, endTime);
     return this._riskPercentiles(ret.durations, totalTime, percentiles,
-        ret.clippedLength);
+      ret.clippedLength);
   }
 
   /**
@@ -479,9 +479,9 @@ class TraceProcessor {
     const firstResourceSendEvt = events.find(e => e.name === 'ResourceSendRequest');
     // We know that these properties exist if we found the events, but TSC doesn't.
     if (navStartEvt?.args?.data &&
-        firstResourceSendEvt &&
-        firstResourceSendEvt.pid === navStartEvt.pid &&
-        firstResourceSendEvt.tid === navStartEvt.tid) {
+      firstResourceSendEvt &&
+      firstResourceSendEvt.pid === navStartEvt.pid &&
+      firstResourceSendEvt.tid === navStartEvt.tid) {
       const frameId = navStartEvt.args.frame;
       if (frameId) {
         return {
@@ -552,9 +552,9 @@ class TraceProcessor {
    */
   static isScheduleableTask(evt) {
     return evt.name === SCHEDULABLE_TASK_TITLE_LH ||
-    evt.name === SCHEDULABLE_TASK_TITLE_ALT1 ||
-    evt.name === SCHEDULABLE_TASK_TITLE_ALT2 ||
-    evt.name === SCHEDULABLE_TASK_TITLE_ALT3;
+      evt.name === SCHEDULABLE_TASK_TITLE_ALT1 ||
+      evt.name === SCHEDULABLE_TASK_TITLE_ALT2 ||
+      evt.name === SCHEDULABLE_TASK_TITLE_ALT3;
   }
 
   /**
@@ -563,7 +563,7 @@ class TraceProcessor {
    */
   static isLCPEvent(evt) {
     if (evt.name !== 'largestContentfulPaint::Invalidate' &&
-        evt.name !== 'largestContentfulPaint::Candidate') return false;
+      evt.name !== 'largestContentfulPaint::Candidate') return false;
     return Boolean(evt.args?.frame);
   }
 
@@ -602,9 +602,10 @@ class TraceProcessor {
    *
    * @param {LH.TraceEvent[]} events
    * @param {LH.TraceEvent} timeOriginEvent
+   * @param {string|undefined} mainFrameId
    * @return {{lcp: LCPEvent | undefined, invalidated: boolean}}
    */
-  static computeValidLCPAllFrames(events, timeOriginEvent) {
+  static computeValidLCPAllFrames(events, timeOriginEvent, mainFrameId) {
     const lcpEvents = events.filter(this.isLCPEvent).reverse();
 
     /** @type {Map<string, LCPEvent>} */
@@ -628,6 +629,53 @@ class TraceProcessor {
       }
     }
 
+    // If no standard LCP candidate is found, try the UKM AllFramesEvents.
+    if (!maxLcpAcrossFrames) {
+      const ukmEvents = events.filter(
+        (e) =>
+          e.name.includes('LargestContentfulPaint') && e.name.includes('UKM')
+      );
+
+      // In the rare cases this whole fallback is necessary, the
+      // NavStartToLargestContentfulPaint::Candidate::AllFrames::UKM events are missing too.
+      // As a result, the only useful signal left is the AllFrames invalidates.
+      // Not ideal since they are 1 paint behind, but.. better than the dreaded
+      // NO_LCP error
+      const targetEventName =
+        'NavStartToLargestContentfulPaint::Invalidate::AllFrames::UKM';
+      const ukmInvalidates = ukmEvents.filter((e) => e.name === targetEventName);
+
+      if (ukmInvalidates.length > 0) {
+        ukmInvalidates.sort((a, b) => a.ts - b.ts);
+        const lastInvalidate = ukmInvalidates[ukmInvalidates.length - 1];
+
+        log.warn(
+          'TraceProcessor',
+          'LCP candidate missing, falling back to UKM Invalidate event.'
+        );
+
+        // Construct a mock LCP candidate event
+        maxLcpAcrossFrames = /** @type {LCPCandidateEvent} */ (
+          /** @type {unknown} */ ({
+            name: 'largestContentfulPaint::Candidate',
+            cat: 'loading',
+            ph: lastInvalidate.ph,
+            ts: lastInvalidate.ts,
+            pid: lastInvalidate.pid,
+            tid: lastInvalidate.tid,
+            args: {
+              frame: mainFrameId || 'main_frame', // Mocked frame ID
+              data: {
+                size: 1, // Don't know the actuall size so we assign it 1
+                isMainFrame: true,
+                isOutermostMainFrame: true,
+              },
+            },
+          })
+        );
+      }
+    }
+
     return {
       lcp: maxLcpAcrossFrames,
       // LCP events were found, but final LCP event of every frame was an invalidate event.
@@ -669,7 +717,7 @@ class TraceProcessor {
    * @param {LH.Trace} trace
    * @param {{timeOriginDeterminationMethod?: TimeOriginDeterminationMethod}} [options]
    * @return {LH.Artifacts.ProcessedTrace}
-  */
+   */
   static processTrace(trace, options) {
     const {timeOriginDeterminationMethod = 'auto'} = options || {};
 
@@ -677,9 +725,9 @@ class TraceProcessor {
     // *must* be stable to keep events correctly nested.
     const keyEvents = this.filteredTraceSort(trace.traceEvents, e => {
       return e.cat.includes('blink.user_timing') ||
-          e.cat.includes('loading') ||
-          e.cat.includes('devtools.timeline') ||
-          e.cat === '__metadata';
+        e.cat.includes('loading') ||
+        e.cat.includes('devtools.timeline') ||
+        e.cat === '__metadata';
     });
 
     // Find the inspected frame
@@ -699,7 +747,7 @@ class TraceProcessor {
     // Begin collection of frame tree information with TracingStartedInBrowser,
     // which should be present even without navigations.
     const tracingStartedFrames = keyEvents
-        .find(e => e.name === 'TracingStartedInBrowser')?.args?.data?.frames;
+      .find(e => e.name === 'TracingStartedInBrowser')?.args?.data?.frames;
     if (tracingStartedFrames) {
       for (const frame of tracingStartedFrames) {
         framesById.set(frame.frame, {
@@ -738,12 +786,18 @@ class TraceProcessor {
     // Filter to just events matching the main frame ID, just to make sure.
     /** @param {LH.TraceEvent} e */
     function associatedToMainFrame(e) {
+      if (e.name === 'NavStartToLargestContentfulPaint::Invalidate::AllFrames::UKM') {
+        return true;
+      }
       const frameId = TraceProcessor.getFrameId(e);
       return frameId === mainFrameInfo.frameId;
     }
 
     /** @param {LH.TraceEvent} e */
     function associatedToAllFrames(e) {
+      if (e.name.includes('LargestContentfulPaint') && e.name.includes('UKM')) {
+        return true;
+      }
       const frameId = TraceProcessor.getFrameId(e);
       return frameId ? inspectedTreeFrameIds.includes(frameId) : false;
     }
@@ -805,9 +859,16 @@ class TraceProcessor {
    * origin in addition to the standard microsecond monotonic timestamps.
    * @param {LH.Artifacts.ProcessedTrace} processedTrace
    * @return {LH.Artifacts.ProcessedNavigation}
-  */
+   */
   static processNavigation(processedTrace) {
-    const {frameEvents, frameTreeEvents, timeOriginEvt, timings, timestamps} = processedTrace;
+    const {
+      frameEvents,
+      frameTreeEvents,
+      timeOriginEvt,
+      timings,
+      timestamps,
+      mainFrameInfo,
+    } = processedTrace;
 
     // Compute the key frame timings for the main frame.
     const frameTimings = this.computeNavigationTimingsForFrame(frameEvents, {timeOriginEvt});
@@ -822,7 +883,11 @@ class TraceProcessor {
     }
 
     // Compute LCP for all frames.
-    const lcpAllFramesEvt = this.computeValidLCPAllFrames(frameTreeEvents, timeOriginEvt).lcp;
+    const lcpAllFramesEvt = this.computeValidLCPAllFrames(
+      frameTreeEvents,
+      timeOriginEvt,
+      mainFrameInfo.frameId
+    ).lcp;
 
     /** @param {number} ts */
     const getTiming = ts => (ts - timeOriginEvt.ts) / 1000;
@@ -950,7 +1015,7 @@ class TraceProcessor {
    * in addition to the standard microsecond monotonic timestamps.
    * @param {Array<LH.TraceEvent>} frameEvents
    * @param {{timeOriginEvt: LH.TraceEvent}} options
-  */
+   */
   static computeNavigationTimingsForFrame(frameEvents, options) {
     const {timeOriginEvt} = options;
 
@@ -967,7 +1032,8 @@ class TraceProcessor {
     }
 
     // This function accepts events spanning multiple frames, but this usage will only provide events from the main frame.
-    const lcpResult = this.computeValidLCPAllFrames(frameEvents, timeOriginEvt);
+    const frameId = frameEvents.map(e => TraceProcessor.getFrameId(e)).find(Boolean);
+    const lcpResult = this.computeValidLCPAllFrames(frameEvents, timeOriginEvt, frameId);
 
     const load = frameEvents.find(e => e.name === 'loadEventEnd' && e.ts > timeOriginEvt.ts);
     const domContentLoaded = frameEvents.find(

package/core/runner.js

@@ -498,6 +498,7 @@ vs: ${JSON.stringify(normalizedAuditSettings[k], null, 2)}`);
           .map(f => `byte-efficiency/${f}`),
       ...fs.readdirSync(path.join(moduleDir, './audits/manual')).map(f => `manual/${f}`),
       ...fs.readdirSync(path.join(moduleDir, './audits/insights')).map(f => `insights/${f}`),
+      ...fs.readdirSync(path.join(moduleDir, './audits/agentic')).map(f => `agentic/${f}`),
     ];
     return fileList.filter(f => {
       return /\.js$/.test(f) && !ignoredFiles.includes(f);
@@ -514,6 +515,8 @@ vs: ${JSON.stringify(normalizedAuditSettings[k], null, 2)}`);
       ...fs.readdirSync(path.join(moduleDir, './gather/gatherers/seo')).map(f => `seo/${f}`),
       ...fs.readdirSync(path.join(moduleDir, './gather/gatherers/dobetterweb'))
           .map(f => `dobetterweb/${f}`),
+      ...fs.readdirSync(path.join(moduleDir, './gather/gatherers/agentic'))
+          .map(f => `agentic/${f}`),
     ];
     return fileList.filter(f => /\.js$/.test(f) && f !== 'gatherer.js').sort();
   }