lighthouse 13.0.3 → 13.1.0

package/types/artifacts.d.ts

@@ -4,22 +4,22 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import {Protocol as Crdp} from 'devtools-protocol/types/protocol.js';
+import { Protocol as Crdp } from 'devtools-protocol/types/protocol.js';
 import * as TraceEngine from '@paulirish/trace_engine';
 import * as Lantern from '../core/lib/lantern/lantern.js';
 
-import {parseManifest} from '../core/lib/manifest-parser.js';
-import {LighthouseError} from '../core/lib/lh-error.js';
-import {NetworkRequest as _NetworkRequest} from '../core/lib/network-request.js';
+import { parseManifest } from '../core/lib/manifest-parser.js';
+import { LighthouseError } from '../core/lib/lh-error.js';
+import { NetworkRequest as _NetworkRequest } from '../core/lib/network-request.js';
 import speedline from 'speedline-core';
 import * as CDTSourceMap from '../core/lib/cdt/generated/SourceMap.js';
-import {ArbitraryEqualityMap} from '../core/lib/arbitrary-equality-map.js';
+import { ArbitraryEqualityMap } from '../core/lib/arbitrary-equality-map.js';
 import type { TaskNode as _TaskNode } from '../core/lib/tracehouse/main-thread-tasks.js';
 import AuditDetails from './lhr/audit-details.js'
 import Config from './config.js';
 import Gatherer from './gatherer.js';
-import {IEntity} from 'third-party-web';
-import {IcuMessage} from './lhr/i18n.js';
+import { IEntity } from 'third-party-web';
+import { IcuMessage } from './lhr/i18n.js';
 import LHResult from './lhr/lhr.js'
 import Protocol from './protocol.js';
 import Util from './utility-types.js';
@@ -51,13 +51,13 @@ interface UniversalBaseArtifacts {
   /** The host's device pixel ratio. */
   HostDPR: number;
   /** Device which Chrome is running on. */
-  HostFormFactor: 'desktop'|'mobile';
+  HostFormFactor: 'desktop' | 'mobile';
   /** The user agent string of the version of Chrome used. */
   HostUserAgent: string;
   /** The product string of the version of Chrome used. Example: HeadlessChrome/123.2.2.0 would be from old headless. */
   HostProduct: string;
   /** Information about how Lighthouse artifacts were gathered. */
-  GatherContext: {gatherMode: Gatherer.GatherMode};
+  GatherContext: { gatherMode: Gatherer.GatherMode };
 }
 
 /**
@@ -87,7 +87,7 @@ interface PublicGathererArtifacts {
   /** The contents of the main HTML document network resource. */
   MainDocumentContent: string;
   /** The values of the <meta> elements in the head. */
-  MetaElements: Array<{name?: string, content?: string, property?: string, httpEquiv?: string, charset?: string, node: Artifacts.NodeDetails}>;
+  MetaElements: Array<{ name?: string, content?: string, property?: string, httpEquiv?: string, charset?: string, node: Artifacts.NodeDetails }>;
   /** Information on all scripts in the page. */
   Scripts: Artifacts.Script[];
   /** The primary trace taken over the entire run. */
@@ -117,7 +117,7 @@ export interface GathererArtifacts extends PublicGathererArtifacts {
   /** All the iframe elements in the page. */
   IFrameElements: Artifacts.IFrameElement[];
   /** All the input elements, including associated form and label elements. */
-  Inputs: {inputs: Artifacts.InputElement[]; forms: Artifacts.FormElement[]; labels: Artifacts.LabelElement[]};
+  Inputs: { inputs: Artifacts.InputElement[]; forms: Artifacts.FormElement[]; labels: Artifacts.LabelElement[] };
   /** Screenshot of the entire page (rather than just the above the fold content). */
   FullPageScreenshot: LHResult.FullPageScreenshot | null;
   /** The issues surfaced in the devtools Issues panel */
@@ -128,7 +128,7 @@ export interface GathererArtifacts extends PublicGathererArtifacts {
   /** The user agent string that Lighthouse used to load the page. Set to the empty string if unknown. */
   NetworkUserAgent: string;
   /** Information on fetching and the content of the /robots.txt file. */
-  RobotsTxt: {status: number|null, content: string|null, errorMessage?: string};
+  RobotsTxt: { status: number | null, content: string | null, errorMessage?: string };
   /** Source maps of scripts executed in the page. */
   SourceMaps: Array<Artifacts.SourceMap>;
   /** Information on detected tech stacks (e.g. JS libraries) used by the page. */
@@ -148,7 +148,7 @@ declare module Artifacts {
 
   type NetworkRequest = _NetworkRequest;
   type TaskNode = _TaskNode;
-  type TBTImpactTask = TaskNode & {tbtImpact: number, selfTbtImpact: number, selfBlockingTime: number};
+  type TBTImpactTask = TaskNode & { tbtImpact: number, selfTbtImpact: number, selfBlockingTime: number };
   type MetaElement = Artifacts['MetaElements'][0];
 
   interface URL {
@@ -188,7 +188,7 @@ declare module Artifacts {
     impact?: string;
     tags: Array<string>;
     nodes: Array<{
-      target: Array<string|string[]>;
+      target: Array<string | string[]>;
       failureSummary?: string;
       node: NodeDetails;
       relatedNodes: NodeDetails[];
@@ -239,7 +239,7 @@ declare module Artifacts {
   /** @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link#Attributes */
   interface LinkElement {
     /** The `rel` attribute of the link, normalized to lower case. @see https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types */
-    rel: 'alternate'|'canonical'|'dns-prefetch'|'preconnect'|'preload'|'stylesheet'|string;
+    rel: 'alternate' | 'canonical' | 'dns-prefetch' | 'preconnect' | 'preload' | 'stylesheet' | string;
     /** The `href` attribute of the link or `null` if it was invalid in the header. */
     href: string | null
     /** The raw value of the `href` attribute. Only different from `href` when source is 'headers' */
@@ -251,13 +251,13 @@ declare module Artifacts {
     /** The `crossOrigin` attribute of the link */
     crossOrigin: string | null
     /** Where the link was found, either in the DOM or in the headers of the main document */
-    source: 'head'|'body'|'headers'
+    source: 'head' | 'body' | 'headers'
     node: NodeDetails | null
     /** The fetch priority hint for preload links. */
     fetchPriority?: string;
   }
 
-  interface Script extends Omit<Crdp.Debugger.ScriptParsedEvent, 'url'|'embedderName'> {
+  interface Script extends Omit<Crdp.Debugger.ScriptParsedEvent, 'url' | 'embedderName'> {
     /**
      * Set by a sourceURL= magic comment if present, otherwise this is the same as the URL.
      * Use this field for presentational purposes only.
@@ -288,7 +288,7 @@ declare module Artifacts {
      * `map` is optional because the spec defines that either `url` or `map` must be defined.
      * We explicitly only support `map` here.
     */
-    sections?: Array<{offset: {line: number, column: number}, map?: RawSourceMap}>
+    sections?: Array<{ offset: { line: number, column: number }, map?: RawSourceMap }>
   }
 
   /**
@@ -326,7 +326,7 @@ declare module Artifacts {
       files: Record<string, number>;
       unmappedBytes: number;
       totalBytes: number;
-    } | {errorMessage: string};
+    } | { errorMessage: string };
   }
 
   /** @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#Attributes */
@@ -429,10 +429,10 @@ declare module Artifacts {
   }
 
   interface TraceElement {
-    traceEventType: 'trace-engine'|'layout-shift'|'animation';
+    traceEventType: 'trace-engine' | 'layout-shift' | 'animation';
     node: NodeDetails;
     nodeId: number;
-    animations?: {name?: string, failureReasonsMask?: number, unsupportedProperties?: string[]}[];
+    animations?: { name?: string, failureReasonsMask?: number, unsupportedProperties?: string[] }[];
     type?: string;
   }
 
@@ -541,9 +541,9 @@ declare module Artifacts {
     /** The subset of trace events from the main frame and any child frames, sorted by timestamp. */
     frameTreeEvents: Array<TraceEvent>;
     /** IDs for the trace's main frame, and process. The startingPid is the initial process id, however cross-origin navigations may incur changes to the pid while the frame ID remains identical. */
-    mainFrameInfo: {startingPid: number, frameId: string};
+    mainFrameInfo: { startingPid: number, frameId: string };
     /** The list of frames committed in the trace. */
-    frames: Array<{id: string, url: string}>;
+    frames: Array<{ id: string, url: string }>;
     /** The trace event marking the time at which the run should consider to have begun. Typically the same as the navigationStart but might differ due to SPA navigations, client-side redirects, etc. In the timespan case, this event is injected by Lighthouse itself. */
     timeOriginEvt: TraceEvent;
     /** All received trace events subsetted to important categories. */
@@ -761,7 +761,7 @@ export interface Trace {
 
 /** The type of the Profile & ProfileChunk event in Chromium traces. Note that this is subtly different from Crdp.Profiler.Profile. */
 export interface TraceCpuProfile {
-  nodes?: Array<{id: number, callFrame: {functionName: string, url?: string}, parent?: number}>
+  nodes?: Array<{ id: number, callFrame: { functionName: string, url?: string }, parent?: number }>
   samples?: Array<number>
   timeDeltas?: Array<number>
 }
@@ -831,7 +831,7 @@ export interface TraceEvent {
       unsupportedProperties?: string[];
       size?: number;
       /** Responsiveness data. */
-      interactionType?: 'drag'|'keyboard'|'tapOrClick';
+      interactionType?: 'drag' | 'keyboard' | 'tapOrClick';
       maxDuration?: number;
       type?: string;
       functionName?: string;
@@ -851,21 +851,24 @@ export interface TraceEvent {
       connectionReused?: boolean;
       encodedDataLength?: number;
       decodedBodyLength?: number;
-      initiator?: {type: string, url?: string, stack?: any};
+      initiator?: { type: string, url?: string, stack?: any };
       protocol?: string;
       finishTime?: number;
-      headers?: Array<{name: string, value: string}>;
+      headers?: Array<{ name: string, value: string }>;
     };
     frame?: string;
     name?: string;
     labels?: string;
+    feature?: string;
+    lineNumber?: number;
+    columnNumber?: number;
   };
   pid: number;
   tid: number;
   /** Timestamp of the event in microseconds. */
   ts: number;
   dur: number;
-  ph: 'B'|'b'|'D'|'E'|'e'|'F'|'I'|'M'|'N'|'n'|'O'|'R'|'S'|'T'|'X';
+  ph: 'B' | 'b' | 'D' | 'E' | 'e' | 'F' | 'I' | 'M' | 'N' | 'n' | 'O' | 'R' | 'S' | 'T' | 'X';
   s?: 't';
   id?: string;
   id2?: {
@@ -873,7 +876,7 @@ export interface TraceEvent {
   };
 }
 
-declare module Trace {
+declare namespace Trace {
   /**
    * Base event of a `ph: 'X'` 'complete' event. Extend with `name` and `args` as
    * needed.
@@ -894,7 +897,7 @@ declare module Trace {
    * more specific `ph` (if needed).
    */
   interface AsyncEvent {
-    ph: 'b'|'e'|'n';
+    ph: 'b' | 'e' | 'n';
     cat: string;
     pid: number;
     tid: number;

package/types/audit.d.ts

@@ -13,7 +13,7 @@ import {IcuMessage} from './lhr/i18n.js';
 import * as AuditResult from './lhr/audit-result.js';
 import Util from './utility-types.js';
 
-declare module Audit {
+declare namespace Audit {
   export import Details = AuditDetails;
   export type Result = AuditResult.Result;
   export type ScoreDisplayMode = AuditResult.ScoreDisplayMode;

package/types/config.d.ts

@@ -28,7 +28,7 @@ interface Config {
   plugins?: Array<string>;
 }
 
-declare module Config {
+declare namespace Config {
   /**
    * The normalized and fully resolved config.
    */

package/types/gatherer.d.ts

@@ -22,7 +22,7 @@ import * as Lantern from '../core/lib/lantern/lantern.js';
 type CrdpEvents = CrdpMappings.Events;
 type CrdpCommands = CrdpMappings.Commands;
 
-declare module Gatherer {
+declare namespace Gatherer {
   /** The Lighthouse wrapper around a raw CDP session. */
   interface ProtocolSession {
     setTargetInfo(targetInfo: Crdp.Target.TargetInfo): void;

package/types/lhr/audit-details.d.ts

@@ -26,7 +26,7 @@ type Details =
   Details.Table;
 
 // Details namespace.
-declare module Details {
+declare namespace Details {
   type NetworkNode = {
     [id: string]: {
       url: string;
@@ -97,7 +97,7 @@ declare module Details {
   // NOTE: any `Details` type *should* be usable in `items`, but check
   // styles/report-ui-features are good before adding.
   type ListableDetail = Table | Checklist | NetworkTree | NodeValue | TextValue | DebugData;
-  
+
   interface ListSectionItem {
     type: 'list-section';
     title?: IcuMessage | string;
@@ -195,10 +195,10 @@ declare module Details {
   }
 
   /** String enum of possible types of values found within table items. */
-  type ItemValueType = 'bytes' | 'code' | 'link' | 'ms' | 'multi' | 'node' | 'source-location' | 'numeric' | 'text' | 'thumbnail' | 'timespanMs' | 'url';
+  type ItemValueType = 'bytes' | 'code' | 'link' | 'ms' | 'multi' | 'node' | 'source-location' | 'numeric' | 'text' | 'thumbnail' | 'timespanMs' | 'url' | 'baseline-status';
 
   /** Possible types of values found within table items. */
-  type ItemValue = string | number | boolean | DebugData | NodeValue | SourceLocationValue | LinkValue | UrlValue | CodeValue | NumericValue | TextValue | IcuMessage | TableSubItems;
+  type ItemValue = string | number | boolean | DebugData | NodeValue | SourceLocationValue | LinkValue | UrlValue | CodeValue | NumericValue | TextValue | IcuMessage | TableSubItems | BaselineStatusValue;
 
   interface TableColumnHeading {
     /**
@@ -363,6 +363,12 @@ declare module Details {
     type: 'text',
     value: IcuMessage | string,
   }
+
+  interface BaselineStatusValue {
+    type: 'baseline-status',
+    status: 'high' | 'low' | 'limited' | string,
+    displayString: IcuMessage | string,
+  }
 }
 
 export default Details;

package/types/lhr/flow-result.d.ts

@@ -6,7 +6,7 @@
 
 import Result from './lhr.js';
 
-declare module FlowResult {
+declare namespace FlowResult {
   interface Step {
     /** Lighthouse report for this flow step. */
     lhr: Result;

package/types/lhr/lhr.d.ts

@@ -70,7 +70,7 @@ interface Result {
 }
 
 // Result namespace
-declare module Result {
+declare namespace Result {
   interface Environment {
     /** The user agent string of the version of Chrome used. */
     hostUserAgent: string;

package/types/lhr/treemap.d.ts

@@ -7,7 +7,7 @@
 import {Result as AuditResult} from './audit-result.js';
 import {Locale} from './settings.js';
 
-declare module Treemap {
+declare namespace Treemap {
   interface Options {
     lhr: {
       mainDocumentUrl?: string;

package/types/protocol.d.ts

@@ -9,7 +9,7 @@ import {ProtocolMapping as CrdpMappings} from 'devtools-protocol/types/protocol-
 type CrdpEvents = CrdpMappings.Events;
 type CrdpCommands = CrdpMappings.Commands;
 
-declare module Protocol {
+declare namespace Protocol {
   type TargetType = 'page' | 'iframe' | 'worker';
 
   /**

package/types/puppeteer.d.ts

@@ -13,7 +13,7 @@ import * as puppeteerCore from 'puppeteer-core';
 
 type IfNotAny<T> = [T & 0] extends [1] ? never : T;
 
-declare module Puppeteer {
+declare namespace Puppeteer {
   // @ts-ignore Puppeteer is an optional dependency. `IfNotAny` will handle the `any` type if it's not installed.
   export type Browser = puppeteerCore.Browser | IfNotAny<import('puppeteer').Browser>;
   // @ts-ignore Puppeteer is an optional dependency. `IfNotAny` will handle the `any` type if it's not installed.

package/types/user-flow.d.ts

@@ -9,7 +9,7 @@ import Config from './config.js';
 import {Flags} from './externs.js';
 import {Artifacts} from './artifacts.js';
 
-declare module UserFlow {
+declare namespace UserFlow {
   export interface FlowArtifacts {
     gatherSteps: GatherStep[];
     name?: string;

package/types/utility-types.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-declare module Util {
+declare namespace Util {
   /** Make properties K in T optional. */
   type MakeOptional<T, K extends keyof T> = {
     [P in Exclude<keyof T, K>]: T[P]