lighthouse 9.5.0-dev.20230117 → 9.5.0-dev.20230119

package/core/lib/url-utils.d.ts

@@ -0,0 +1,100 @@
+export default UrlUtils;
+export type NetworkRequest = import('./network-request.js').NetworkRequest;
+declare class UrlUtils {
+    /**
+     * @param {string} url
+     * @return {boolean}
+     */
+    static isValid(url: string): boolean;
+    /**
+     * @param {string} urlA
+     * @param {string} urlB
+     * @return {boolean}
+     */
+    static hostsMatch(urlA: string, urlB: string): boolean;
+    /**
+     * @param {string} urlA
+     * @param {string} urlB
+     * @return {boolean}
+     */
+    static originsMatch(urlA: string, urlB: string): boolean;
+    /**
+     * @param {string} url
+     * @return {?string}
+     */
+    static getOrigin(url: string): string | null;
+    /**
+     * Check if rootDomains matches
+     *
+     * @param {string|URL} urlA
+     * @param {string|URL} urlB
+     */
+    static rootDomainsMatch(urlA: string | URL, urlB: string | URL): boolean;
+    /**
+     * @param {string} url
+     * @param {{numPathParts: number, preserveQuery: boolean, preserveHost: boolean}=} options
+     * @return {string}
+     */
+    static getURLDisplayName(url: string, options?: {
+        numPathParts: number;
+        preserveQuery: boolean;
+        preserveHost: boolean;
+    } | undefined): string;
+    /**
+     * Limits data URIs to 100 characters, returns all other strings untouched.
+     * @param {string} url
+     * @return {string}
+     */
+    static elideDataURI(url: string): string;
+    /**
+     * Determine if url1 equals url2, ignoring URL fragments.
+     * @param {string} url1
+     * @param {string} url2
+     * @return {boolean}
+     */
+    static equalWithExcludedFragments(url1: string, url2: string): boolean;
+    /**
+     * Determine if the url has a protocol that we're able to test
+     * @param {string} url
+     * @return {boolean}
+     */
+    static isProtocolAllowed(url: string): boolean;
+    /**
+     * Is the host localhost-enough to satisfy the "secure context" definition
+     * https://github.com/GoogleChrome/lighthouse/pull/11766#discussion_r582340683
+     * @param {string} hostname Either a `new URL(url).hostname` or a `networkRequest.parsedUrl.host`
+     * @return {boolean}
+     */
+    static isLikeLocalhost(hostname: string): boolean;
+    /**
+     * @param {NetworkRequest['parsedURL']['scheme']} scheme
+     * @return {boolean}
+     */
+    static isSecureScheme(scheme: NetworkRequest['parsedURL']['scheme']): boolean;
+    /**
+     * Use `NetworkRequest.isNonNetworkRequest(req)` if working with a request.
+     * Note: the `protocol` field from CDP can be 'h2', 'http', (not 'https'!) or it'll be url's scheme.
+     *   https://source.chromium.org/chromium/chromium/src/+/main:content/browser/devtools/protocol/network_handler.cc;l=598-611;drc=56d4a9a9deb30be73adcee8737c73bcb2a5ab64f
+     * However, a `new URL(href).protocol` has a colon suffix.
+     *   https://url.spec.whatwg.org/#dom-url-protocol
+     * A URL's `scheme` is specced as the `protocol` sans-colon, but isn't exposed on a URL object.
+     * This method can take all 3 of these string types as a parameter.
+     * @param {NetworkRequest['protocol'] | URL['protocol']} protocol Either a networkRequest's `protocol` per CDP or a `new URL(href).protocol`
+     * @return {boolean}
+     */
+    static isNonNetworkProtocol(protocol: NetworkRequest['protocol'] | URL['protocol']): boolean;
+    /**
+     * @param {string} src
+     * @return {string|undefined}
+     */
+    static guessMimeType(src: string): string | undefined;
+    /**
+     * @param {string|undefined} url
+     * @return {string}
+     */
+    static normalizeUrl(url: string | undefined): string;
+}
+declare namespace UrlUtils {
+    const INVALID_URL_DEBUG_STRING: string;
+}
+//# sourceMappingURL=url-utils.d.ts.map

package/core/runner.d.ts

@@ -0,0 +1,109 @@
+export type Connection = import('./legacy/gather/connections/connection.js').Connection;
+export type ArbitraryEqualityMap = import('./lib/arbitrary-equality-map.js').ArbitraryEqualityMap;
+export type Config = LH.Config.LegacyResolvedConfig;
+/** @typedef {import('./legacy/gather/connections/connection.js').Connection} Connection */
+/** @typedef {import('./lib/arbitrary-equality-map.js').ArbitraryEqualityMap} ArbitraryEqualityMap */
+/** @typedef {LH.Config.LegacyResolvedConfig} Config */
+export class Runner {
+    /**
+     * @template {LH.Config.LegacyResolvedConfig | LH.Config.ResolvedConfig} TConfig
+     * @param {LH.Artifacts} artifacts
+     * @param {{resolvedConfig: TConfig, driverMock?: Driver, computedCache: Map<string, ArbitraryEqualityMap>}} options
+     * @return {Promise<LH.RunnerResult|undefined>}
+     */
+    static audit<TConfig extends import("../types/config.js").default.ResolvedConfig | import("../types/config.js").default.LegacyResolvedConfig>(artifacts: LH.Artifacts, options: {
+        resolvedConfig: TConfig;
+        driverMock?: Driver | undefined;
+        computedCache: Map<string, ArbitraryEqualityMap>;
+    }): Promise<LH.RunnerResult | undefined>;
+    /**
+     * User can run -G solo, -A solo, or -GA together
+     * -G and -A will run partial lighthouse pipelines,
+     * and -GA will run everything plus save artifacts and lhr to disk.
+     *
+     * @template {LH.Config.LegacyResolvedConfig | LH.Config.ResolvedConfig} TConfig
+     * @param {(runnerData: {resolvedConfig: TConfig, driverMock?: Driver}) => Promise<LH.Artifacts>} gatherFn
+     * @param {{resolvedConfig: TConfig, driverMock?: Driver, computedCache: Map<string, ArbitraryEqualityMap>}} options
+     * @return {Promise<LH.Artifacts>}
+     */
+    static gather<TConfig_1 extends import("../types/config.js").default.ResolvedConfig | import("../types/config.js").default.LegacyResolvedConfig>(gatherFn: (runnerData: {
+        resolvedConfig: TConfig_1;
+        driverMock?: Driver | undefined;
+    }) => Promise<LH.Artifacts>, options: {
+        resolvedConfig: TConfig_1;
+        driverMock?: Driver | undefined;
+        computedCache: Map<string, ArbitraryEqualityMap>;
+    }): Promise<LH.Artifacts>;
+    /**
+     * @param {any} err
+     * @param {LH.Config.Settings} settings
+     */
+    static createRunnerError(err: any, settings: LH.Config.Settings): any;
+    /**
+     * This handles both the auditMode case where gatherer entries need to be merged in and
+     * the gather/audit case where timingEntriesFromRunner contains all entries from this run,
+     * including those also in timingEntriesFromArtifacts.
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.Result.Timing}
+     */
+    static _getTiming(artifacts: LH.Artifacts): LH.Result.Timing;
+    /**
+     * Establish connection, load page and collect all required artifacts
+     * @param {string} requestedUrl
+     * @param {{resolvedConfig: Config, computedCache: Map<string, ArbitraryEqualityMap>, driverMock?: Driver}} runnerOpts
+     * @param {Connection} connection
+     * @return {Promise<LH.Artifacts>}
+     */
+    static _gatherArtifactsFromBrowser(requestedUrl: string, runnerOpts: {
+        resolvedConfig: Config;
+        computedCache: Map<string, ArbitraryEqualityMap>;
+        driverMock?: Driver;
+    }, connection: Connection): Promise<LH.Artifacts>;
+    /**
+     * Run all audits with specified settings and artifacts.
+     * @param {LH.Config.Settings} settings
+     * @param {Array<LH.Config.AuditDefn>} audits
+     * @param {LH.Artifacts} artifacts
+     * @param {Array<string | LH.IcuMessage>} runWarnings
+     * @param {Map<string, ArbitraryEqualityMap>} computedCache
+     * @return {Promise<Record<string, LH.RawIcu<LH.Audit.Result>>>}
+     */
+    static _runAudits(settings: LH.Config.Settings, audits: Array<LH.Config.AuditDefn>, artifacts: LH.Artifacts, runWarnings: Array<string | LH.IcuMessage>, computedCache: Map<string, ArbitraryEqualityMap>): Promise<Record<string, LH.RawIcu<LH.Audit.Result>>>;
+    /**
+     * Checks that the audit's required artifacts exist and runs the audit if so.
+     * Otherwise returns error audit result.
+     * @param {LH.Config.AuditDefn} auditDefn
+     * @param {LH.Artifacts} artifacts
+     * @param {Pick<LH.Audit.Context, 'settings'|'computedCache'>} sharedAuditContext
+     * @param {Array<string | LH.IcuMessage>} runWarnings
+     * @return {Promise<LH.RawIcu<LH.Audit.Result>>}
+     * @private
+     */
+    private static _runAudit;
+    /**
+     * Searches a pass's artifacts for any `lhrRuntimeError` error artifacts.
+     * Returns the first one found or `null` if none found.
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.RawIcu<LH.Result['runtimeError']>|undefined}
+     */
+    static getArtifactRuntimeError(artifacts: LH.Artifacts): LH.RawIcu<LH.Result['runtimeError']> | undefined;
+    /**
+     * Returns list of audit names for external querying.
+     * @return {Array<string>}
+     */
+    static getAuditList(): Array<string>;
+    /**
+     * Returns list of gatherer names for external querying.
+     * @return {Array<string>}
+     */
+    static getGathererList(): Array<string>;
+    /**
+     * Get path to use for -G and -A modes. Defaults to $CWD/latest-run
+     * @param {LH.Config.Settings} settings
+     * @return {string}
+     */
+    static _getDataSavePath(settings: LH.Config.Settings): string;
+}
+import { Driver } from "./legacy/gather/driver.js";
+import { Audit } from "./audits/audit.js";
+//# sourceMappingURL=runner.d.ts.map

package/core/scoring.d.ts

@@ -0,0 +1,26 @@
+export class ReportScoring {
+    /**
+     * Computes the weighted-average of the score of the list of items.
+     * @param {Array<{score: number|null, weight: number}>} items
+     * @return {number|null}
+     */
+    static arithmeticMean(items: Array<{
+        score: number | null;
+        weight: number;
+    }>): number | null;
+    /**
+     * Returns the report JSON object with computed scores.
+     * @param {Object<string, LH.Config.Category>} configCategories
+     * @param {Object<string, LH.RawIcu<LH.Audit.Result>>} resultsByAuditId
+     * @return {Object<string, LH.RawIcu<LH.Result.Category>>}
+     */
+    static scoreAllCategories(configCategories: {
+        [x: string]: LH.Config.Category;
+    }, resultsByAuditId: {
+        [x: string]: LH.RawIcu<LH.Audit.Result>;
+    }): {
+        [x: string]: LH.RawIcu<LH.Result.Category>;
+    };
+}
+import { Audit } from "./audits/audit.js";
+//# sourceMappingURL=scoring.d.ts.map

package/core/user-flow.d.ts

@@ -0,0 +1,106 @@
+export type GatherStepRunnerOptions = WeakMap<LH.UserFlow.GatherStep, LH.Gatherer.FRGatherResult['runnerOptions']>;
+export class UserFlow {
+    /**
+     * @param {LH.Puppeteer.Page} page
+     * @param {LH.UserFlow.Options} [options]
+     */
+    constructor(page: LH.Puppeteer.Page, options?: LH.UserFlow.Options | undefined);
+    /** @type {LH.Puppeteer.Page} */
+    _page: LH.Puppeteer.Page;
+    /** @type {LH.UserFlow.Options|undefined} */
+    _options: LH.UserFlow.Options | undefined;
+    /** @type {LH.UserFlow.GatherStep[]} */
+    _gatherSteps: LH.UserFlow.GatherStep[];
+    /** @type {GatherStepRunnerOptions} */
+    _gatherStepRunnerOptions: GatherStepRunnerOptions;
+    /**
+     * @param {LH.UserFlow.StepFlags|undefined} flags
+     * @return {LH.UserFlow.StepFlags|undefined}
+     */
+    _getNextFlags(flags: LH.UserFlow.StepFlags | undefined): LH.UserFlow.StepFlags | undefined;
+    /**
+     * @param {LH.UserFlow.StepFlags|undefined} flags
+     * @return {LH.UserFlow.StepFlags}
+     */
+    _getNextNavigationFlags(flags: LH.UserFlow.StepFlags | undefined): LH.UserFlow.StepFlags;
+    /**
+     * @param {LH.Gatherer.FRGatherResult} gatherResult
+     * @param {LH.UserFlow.StepFlags} [flags]
+     */
+    _addGatherStep(gatherResult: LH.Gatherer.FRGatherResult, flags?: LH.UserFlow.StepFlags | undefined): void;
+    /**
+     * @param {LH.NavigationRequestor} requestor
+     * @param {LH.UserFlow.StepFlags} [flags]
+     */
+    navigate(requestor: LH.NavigationRequestor, flags?: LH.UserFlow.StepFlags | undefined): Promise<void>;
+    /**
+     * This is an alternative to `navigate()` that can be used to analyze a navigation triggered by user interaction.
+     * For more on user triggered navigations, see https://github.com/GoogleChrome/lighthouse/blob/main/docs/user-flows.md#triggering-a-navigation-via-user-interactions.
+     *
+     * @param {LH.UserFlow.StepFlags} [stepOptions]
+     */
+    startNavigation(stepOptions?: LH.UserFlow.StepFlags | undefined): Promise<void>;
+    currentNavigation: {
+        continueAndAwaitResult: () => Promise<void>;
+    } | undefined;
+    endNavigation(): Promise<void>;
+    /**
+     * @param {LH.UserFlow.StepFlags} [flags]
+     */
+    startTimespan(flags?: LH.UserFlow.StepFlags | undefined): Promise<void>;
+    currentTimespan: {
+        timespan: {
+            endTimespanGather(): Promise<LH.Gatherer.FRGatherResult>;
+        };
+        flags: LH.UserFlow.StepFlags | undefined;
+    } | undefined;
+    endTimespan(): Promise<void>;
+    /**
+     * @param {LH.UserFlow.StepFlags} [flags]
+     */
+    snapshot(flags?: LH.UserFlow.StepFlags | undefined): Promise<void>;
+    /**
+     * @returns {Promise<LH.FlowResult>}
+     */
+    createFlowResult(): Promise<LH.FlowResult>;
+    /**
+     * @return {Promise<string>}
+     */
+    generateReport(): Promise<string>;
+    /**
+     * @return {LH.UserFlow.FlowArtifacts}
+     */
+    createArtifactsJson(): LH.UserFlow.FlowArtifacts;
+}
+/**
+ * @param {Array<LH.UserFlow.GatherStep>} gatherSteps
+ * @param {{name?: string, config?: LH.Config, gatherStepRunnerOptions?: GatherStepRunnerOptions}} options
+ */
+export function auditGatherSteps(gatherSteps: Array<LH.UserFlow.GatherStep>, options: {
+    name?: string;
+    config?: LH.Config;
+    gatherStepRunnerOptions?: GatherStepRunnerOptions;
+}): Promise<{
+    steps: LH.FlowResult.Step[];
+    name: string;
+}>;
+/**
+ * @param {LH.UserFlow.StepFlags|undefined} flags
+ * @param {LH.Artifacts} artifacts
+ * @return {string}
+ */
+export function getStepName(flags: LH.UserFlow.StepFlags | undefined, artifacts: LH.Artifacts): string;
+/**
+ * @param {string|undefined} name
+ * @param {LH.UserFlow.GatherStep[]} gatherSteps
+ * @return {string}
+ */
+export function getFlowName(name: string | undefined, gatherSteps: LH.UserFlow.GatherStep[]): string;
+export namespace UIStrings {
+    const defaultFlowName: string;
+    const defaultNavigationName: string;
+    const defaultTimespanName: string;
+    const defaultSnapshotName: string;
+}
+import * as LH from "../types/lh.js";
+//# sourceMappingURL=user-flow.d.ts.map

package/core/user-flow.js

@@ -13,6 +13,7 @@ import {initializeConfig} from './config/config.js';
 import {getFormatted} from '../shared/localization/format.js';
 import {mergeConfigFragment, deepClone} from './config/config-helpers.js';
 import * as i18n from './lib/i18n/i18n.js';
+import * as LH from '../types/lh.js';
 
 /** @typedef {WeakMap<LH.UserFlow.GatherStep, LH.Gatherer.FRGatherResult['runnerOptions']>} GatherStepRunnerOptions */
 

package/core/util.d.cts

@@ -0,0 +1,230 @@
+export type I18n<T> = any;
+export class Util {
+    /** @type {I18n<typeof UIStrings>} */
+    static i18n: any;
+    static get PASS_THRESHOLD(): number;
+    static get MS_DISPLAY_VALUE(): string;
+    /**
+     * If LHR is older than 10.0 it will not have the `finalDisplayedUrl` property.
+     * Old LHRs should have the `finalUrl` property which will work fine for the report.
+     *
+     * @param {LH.Result} lhr
+     */
+    static getFinalDisplayedUrl(lhr: LH.Result): string;
+    /**
+     * If LHR is older than 10.0 it will not have the `mainDocumentUrl` property.
+     * Old LHRs should have the `finalUrl` property which is the same as `mainDocumentUrl`.
+     *
+     * @param {LH.Result} lhr
+     */
+    static getMainDocumentUrl(lhr: LH.Result): string | undefined;
+    /**
+     * Returns a new LHR that's reshaped for slightly better ergonomics within the report rendereer.
+     * Also, sets up the localized UI strings used within renderer and makes changes to old LHRs to be
+     * compatible with current renderer.
+     * The LHR passed in is not mutated.
+     * TODO(team): we all agree the LHR shape change is technical debt we should fix
+     * @param {LH.Result} result
+     * @return {LH.ReportResult}
+     */
+    static prepareReportResult(result: LH.Result): LH.ReportResult;
+    /**
+     * @param {LH.Result} lhr
+     * @return {LH.Result.FullPageScreenshot=}
+     */
+    static getFullPageScreenshot(lhr: LH.Result): LH.Result.FullPageScreenshot | undefined;
+    /**
+     * Used to determine if the "passed" for the purposes of showing up in the "failed" or "passed"
+     * sections of the report.
+     *
+     * @param {{score: (number|null), scoreDisplayMode: string}} audit
+     * @return {boolean}
+     */
+    static showAsPassed(audit: {
+        score: (number | null);
+        scoreDisplayMode: string;
+    }): boolean;
+    /**
+     * Convert a score to a rating label.
+     * TODO: Return `'error'` for `score === null && !scoreDisplayMode`.
+     *
+     * @param {number|null} score
+     * @param {string=} scoreDisplayMode
+     * @return {string}
+     */
+    static calculateRating(score: number | null, scoreDisplayMode?: string | undefined): string;
+    /**
+     * Split a string by markdown code spans (enclosed in `backticks`), splitting
+     * into segments that were enclosed in backticks (marked as `isCode === true`)
+     * and those that outside the backticks (`isCode === false`).
+     * @param {string} text
+     * @return {Array<{isCode: true, text: string}|{isCode: false, text: string}>}
+     */
+    static splitMarkdownCodeSpans(text: string): Array<{
+        isCode: true;
+        text: string;
+    } | {
+        isCode: false;
+        text: string;
+    }>;
+    /**
+     * Split a string on markdown links (e.g. [some link](https://...)) into
+     * segments of plain text that weren't part of a link (marked as
+     * `isLink === false`), and segments with text content and a URL that did make
+     * up a link (marked as `isLink === true`).
+     * @param {string} text
+     * @return {Array<{isLink: true, text: string, linkHref: string}|{isLink: false, text: string}>}
+     */
+    static splitMarkdownLink(text: string): Array<{
+        isLink: true;
+        text: string;
+        linkHref: string;
+    } | {
+        isLink: false;
+        text: string;
+    }>;
+    /**
+     * @param {URL} parsedUrl
+     * @param {{numPathParts?: number, preserveQuery?: boolean, preserveHost?: boolean}=} options
+     * @return {string}
+     */
+    static getURLDisplayName(parsedUrl: URL, options?: {
+        numPathParts?: number | undefined;
+        preserveQuery?: boolean | undefined;
+        preserveHost?: boolean | undefined;
+    } | undefined): string;
+    /**
+     * Split a URL into a file, hostname and origin for easy display.
+     * @param {string} url
+     * @return {{file: string, hostname: string, origin: string}}
+     */
+    static parseURL(url: string): {
+        file: string;
+        hostname: string;
+        origin: string;
+    };
+    /**
+     * @param {string|URL} value
+     * @return {!URL}
+     */
+    static createOrReturnURL(value: string | URL): URL;
+    /**
+     * Gets the tld of a domain
+     *
+     * @param {string} hostname
+     * @return {string} tld
+     */
+    static getTld(hostname: string): string;
+    /**
+     * Returns a primary domain for provided hostname (e.g. www.example.com -> example.com).
+     * @param {string|URL} url hostname or URL object
+     * @return {string}
+     */
+    static getRootDomain(url: string | URL): string;
+    /**
+     * @param {LH.Result['configSettings']} settings
+     * @return {!{deviceEmulation: string, screenEmulation?: string, networkThrottling: string, cpuThrottling: string, summary: string}}
+     */
+    static getEmulationDescriptions(settings: LH.Result['configSettings']): {
+        deviceEmulation: string;
+        screenEmulation?: string | undefined;
+        networkThrottling: string;
+        cpuThrottling: string;
+        summary: string;
+    };
+    /**
+     * Returns only lines that are near a message, or the first few lines if there are
+     * no line messages.
+     * @param {LH.Audit.Details.SnippetValue['lines']} lines
+     * @param {LH.Audit.Details.SnippetValue['lineMessages']} lineMessages
+     * @param {number} surroundingLineCount Number of lines to include before and after
+     * the message. If this is e.g. 2 this function might return 5 lines.
+     */
+    static filterRelevantLines(lines: LH.Audit.Details.SnippetValue['lines'], lineMessages: LH.Audit.Details.SnippetValue['lineMessages'], surroundingLineCount: number): {
+        content: string;
+        lineNumber: number;
+        truncated?: boolean | undefined;
+    }[];
+    /**
+     * @param {string} categoryId
+     */
+    static isPluginCategory(categoryId: string): boolean;
+    /**
+     * @param {LH.Result.GatherMode} gatherMode
+     */
+    static shouldDisplayAsFraction(gatherMode: LH.Result.GatherMode): boolean;
+    /**
+     * @param {LH.ReportResult.Category} category
+     */
+    static calculateCategoryFraction(category: LH.ReportResult.Category): {
+        numPassed: number;
+        numPassableAudits: number;
+        numInformative: number;
+        totalWeight: number;
+    };
+}
+export namespace Util {
+    export const reportJson: LH.ReportResult | null;
+    /**
+     * An always-increasing counter for making unique SVG ID suffixes.
+     */
+    export function getUniqueSuffix(): number;
+    export function resetUniqueSuffix(): void;
+    export { UIStrings };
+}
+export namespace UIStrings {
+    const varianceDisclaimer: string;
+    const calculatorLink: string;
+    const showRelevantAudits: string;
+    const opportunityResourceColumnLabel: string;
+    const opportunitySavingsColumnLabel: string;
+    const errorMissingAuditInfo: string;
+    const errorLabel: string;
+    const warningHeader: string;
+    const warningAuditsGroupTitle: string;
+    const passedAuditsGroupTitle: string;
+    const notApplicableAuditsGroupTitle: string;
+    const manualAuditsGroupTitle: string;
+    const toplevelWarningsMessage: string;
+    const crcInitialNavigation: string;
+    const crcLongestDurationLabel: string;
+    const snippetExpandButtonLabel: string;
+    const snippetCollapseButtonLabel: string;
+    const lsPerformanceCategoryDescription: string;
+    const labDataTitle: string;
+    const thirdPartyResourcesLabel: string;
+    const viewTreemapLabel: string;
+    const viewTraceLabel: string;
+    const viewOriginalTraceLabel: string;
+    const dropdownPrintSummary: string;
+    const dropdownPrintExpanded: string;
+    const dropdownCopyJSON: string;
+    const dropdownSaveHTML: string;
+    const dropdownSaveJSON: string;
+    const dropdownViewer: string;
+    const dropdownSaveGist: string;
+    const dropdownDarkTheme: string;
+    const runtimeSettingsDevice: string;
+    const runtimeSettingsNetworkThrottling: string;
+    const runtimeSettingsCPUThrottling: string;
+    const runtimeSettingsUANetwork: string;
+    const runtimeSettingsBenchmark: string;
+    const runtimeSettingsAxeVersion: string;
+    const runtimeSettingsScreenEmulation: string;
+    const footerIssue: string;
+    const runtimeNoEmulation: string;
+    const runtimeMobileEmulation: string;
+    const runtimeDesktopEmulation: string;
+    const runtimeUnknown: string;
+    const runtimeSingleLoad: string;
+    const runtimeAnalysisWindow: string;
+    const runtimeSingleLoadTooltip: string;
+    const throttlingProvided: string;
+    const show: string;
+    const hide: string;
+    const expandView: string;
+    const collapseView: string;
+    const runtimeSlow4g: string;
+    const runtimeCustom: string;
+}
+//# sourceMappingURL=util.d.cts.map

package/dist/report/bundle.esm.js

@@ -3840,8 +3840,10 @@ class PerformanceCategoryRenderer extends CategoryRenderer {
   _getScoringCalculatorHref(auditRefs) {
     // TODO: filter by !!acronym when dropping renderer support of v7 LHRs.
     const metrics = auditRefs.filter(audit => audit.group === 'metrics');
+    const tti = auditRefs.find(audit => audit.id === 'interactive');
     const fci = auditRefs.find(audit => audit.id === 'first-cpu-idle');
     const fmp = auditRefs.find(audit => audit.id === 'first-meaningful-paint');
+    if (tti) metrics.push(tti);
     if (fci) metrics.push(fci);
     if (fmp) metrics.push(fmp);
 

package/dist/report/flow.js

@@ -117,7 +117,7 @@ class Ca{constructor(e,a){this._document=e,this._lighthouseChannel="unknown",thi
    * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    * See the License for the specific language governing permissions and
    * limitations under the License.
-   */class La extends wa{_renderMetric(e){const a=this.dom.createComponent("metric"),n=this.dom.find(".lh-metric",a);n.id=e.result.id;const t=de.calculateRating(e.result.score,e.result.scoreDisplayMode);n.classList.add(`lh-metric--${t}`);this.dom.find(".lh-metric__title",a).textContent=e.result.title;const i=this.dom.find(".lh-metric__value",a);i.textContent=e.result.displayValue||"";const o=this.dom.find(".lh-metric__description",a);if(o.append(this.dom.convertMarkdownLinkSnippets(e.result.description)),"error"===e.result.scoreDisplayMode){o.textContent="",i.textContent="Error!";this.dom.createChildOf(o,"span").textContent=e.result.errorMessage||"Report error: no metric information"}else"notApplicable"===e.result.scoreDisplayMode&&(i.textContent="--");return n}_renderOpportunity(e,a){const n=this.dom.createComponent("opportunity"),t=this.populateAuditValues(e,n);if(t.id=e.result.id,!e.result.details||"error"===e.result.scoreDisplayMode)return t;const i=e.result.details;if("opportunity"!==i.type)return t;const o=this.dom.find("span.lh-audit__display-text, div.lh-audit__display-text",t),r=i.overallSavingsMs/a*100+"%";if(this.dom.find("div.lh-sparkline__bar",t).style.width=r,o.textContent=de.i18n.formatSeconds(i.overallSavingsMs,.01),e.result.displayValue){const a=e.result.displayValue;this.dom.find("div.lh-load-opportunity__sparkline",t).title=a,o.title=a}return t}_getWastedMs(e){if(e.result.details&&"opportunity"===e.result.details.type){const a=e.result.details;if("number"!=typeof a.overallSavingsMs)throw new Error("non-opportunity details passed to _getWastedMs");return a.overallSavingsMs}return Number.MIN_VALUE}_getScoringCalculatorHref(e){const a=e.filter((e=>"metrics"===e.group)),n=e.find((e=>"first-cpu-idle"===e.id)),t=e.find((e=>"first-meaningful-paint"===e.id));n&&a.push(n),t&&a.push(t);const i=[...a.map((e=>{let a;var n;return"number"==typeof e.result.numericValue?(a="cumulative-layout-shift"===e.id?(n=e.result.numericValue,Math.round(100*n)/100):Math.round(e.result.numericValue),a=a.toString()):a="null",[e.acronym||e.id,a]}))];de.reportJson&&(i.push(["device",de.reportJson.configSettings.formFactor]),i.push(["version",de.reportJson.lighthouseVersion]));const o=new URLSearchParams(i),r=new URL("https://googlechrome.github.io/lighthouse/scorecalc/");return r.hash=o.toString(),r.href}_classifyPerformanceAudit(e){return e.group?null:e.result.details&&"opportunity"===e.result.details.type?"load-opportunity":"diagnostic"}render(e,a,n){const t=de.i18n.strings,i=this.dom.createElement("div","lh-category");i.id=e.id,i.append(this.renderCategoryHeader(e,a,n));const o=e.auditRefs.filter((e=>"metrics"===e.group));if(o.length){const[n,r]=this.renderAuditGroup(a.metrics),s=this.dom.createElement("input","lh-metrics-toggle__input"),l=`lh-metrics-toggle${de.getUniqueSuffix()}`;s.setAttribute("aria-label","Toggle the display of metric descriptions"),s.type="checkbox",s.id=l,n.prepend(s);const p=this.dom.find(".lh-audit-group__header",n),u=this.dom.createChildOf(p,"label","lh-metrics-toggle__label");u.htmlFor=l;const c=this.dom.createChildOf(u,"span","lh-metrics-toggle__labeltext--show"),d=this.dom.createChildOf(u,"span","lh-metrics-toggle__labeltext--hide");c.textContent=de.i18n.strings.expandView,d.textContent=de.i18n.strings.collapseView;const m=this.dom.createElement("div","lh-metrics-container");if(n.insertBefore(m,r),o.forEach((e=>{m.append(this._renderMetric(e))})),i.querySelector(".lh-gauge__wrapper")){const a=this.dom.find(".lh-category-header__description",i),n=this.dom.createChildOf(a,"div","lh-metrics__disclaimer"),o=this.dom.convertMarkdownLinkSnippets(t.varianceDisclaimer);n.append(o);const r=this.dom.createChildOf(n,"a","lh-calclink");r.target="_blank",r.textContent=t.calculatorLink,this.dom.safelySetHref(r,this._getScoringCalculatorHref(e.auditRefs))}n.classList.add("lh-audit-group--metrics"),i.append(n)}const r=this.dom.createChildOf(i,"div","lh-filmstrip-container"),s=e.auditRefs.find((e=>"screenshot-thumbnails"===e.id))?.result;if(s?.details){r.id=s.id;const e=this.detailsRenderer.render(s.details);e&&r.append(e)}const l=e.auditRefs.filter((e=>"load-opportunity"===this._classifyPerformanceAudit(e))).filter((e=>!de.showAsPassed(e.result))).sort(((e,a)=>this._getWastedMs(a)-this._getWastedMs(e))),p=o.filter((e=>!!e.relevantAudits));if(p.length&&this.renderMetricAuditFilter(p,i),l.length){const e=2e3,n=l.map((e=>this._getWastedMs(e))),o=Math.max(...n),r=Math.max(1e3*Math.ceil(o/1e3),e),[s,p]=this.renderAuditGroup(a["load-opportunities"]),u=this.dom.createComponent("opportunityHeader");this.dom.find(".lh-load-opportunity__col--one",u).textContent=t.opportunityResourceColumnLabel,this.dom.find(".lh-load-opportunity__col--two",u).textContent=t.opportunitySavingsColumnLabel;const c=this.dom.find(".lh-load-opportunity__header",u);s.insertBefore(c,p),l.forEach((e=>s.insertBefore(this._renderOpportunity(e,r),p))),s.classList.add("lh-audit-group--load-opportunities"),i.append(s)}const u=e.auditRefs.filter((e=>"diagnostic"===this._classifyPerformanceAudit(e))).filter((e=>!de.showAsPassed(e.result))).sort(((e,a)=>("informative"===e.result.scoreDisplayMode?100:Number(e.result.score))-("informative"===a.result.scoreDisplayMode?100:Number(a.result.score))));if(u.length){const[e,n]=this.renderAuditGroup(a.diagnostics);u.forEach((a=>e.insertBefore(this.renderAudit(a),n))),e.classList.add("lh-audit-group--diagnostics"),i.append(e)}const c=e.auditRefs.filter((e=>this._classifyPerformanceAudit(e)&&de.showAsPassed(e.result)));if(!c.length)return i;const d={auditRefs:c,groupDefinitions:a},m=this.renderClump("passed",d);i.append(m);const h=[];if(["performance-budget","timing-budget"].forEach((a=>{const n=e.auditRefs.find((e=>e.id===a));if(n?.result.details){const e=this.detailsRenderer.render(n.result.details);e&&(e.id=a,e.classList.add("lh-details","lh-details--budget","lh-audit"),h.push(e))}})),h.length>0){const[e,n]=this.renderAuditGroup(a.budgets);h.forEach((a=>e.insertBefore(a,n))),e.classList.add("lh-audit-group--budgets"),i.append(e)}return i}renderMetricAuditFilter(e,a){const n=this.dom.createElement("div","lh-metricfilter");this.dom.createChildOf(n,"span","lh-metricfilter__text").textContent=de.i18n.strings.showRelevantAudits;const t=[{acronym:"All"},...e],i=de.getUniqueSuffix();for(const e of t){const t=`metric-${e.acronym}-${i}`,o=this.dom.createChildOf(n,"input","lh-metricfilter__radio");o.type="radio",o.name=`metricsfilter-${i}`,o.id=t;const r=this.dom.createChildOf(n,"label","lh-metricfilter__label");r.htmlFor=t,r.title=e.result?.title,r.textContent=e.acronym||e.id,"All"===e.acronym&&(o.checked=!0,r.classList.add("lh-metricfilter__label--active")),a.append(n),o.addEventListener("input",(n=>{for(const e of a.querySelectorAll("label.lh-metricfilter__label"))e.classList.toggle("lh-metricfilter__label--active",e.htmlFor===t);a.classList.toggle("lh-category--filtered","All"!==e.acronym);for(const n of a.querySelectorAll("div.lh-audit"))"All"!==e.acronym?(n.hidden=!0,e.relevantAudits&&e.relevantAudits.includes(n.id)&&(n.hidden=!1)):n.hidden=!1;const i=a.querySelectorAll("div.lh-audit-group, details.lh-audit-group");for(const e of i){e.hidden=!1;const a=Array.from(e.querySelectorAll("div.lh-audit")),n=!!a.length&&a.every((e=>e.hidden));e.hidden=n}}))}}}
+   */class La extends wa{_renderMetric(e){const a=this.dom.createComponent("metric"),n=this.dom.find(".lh-metric",a);n.id=e.result.id;const t=de.calculateRating(e.result.score,e.result.scoreDisplayMode);n.classList.add(`lh-metric--${t}`);this.dom.find(".lh-metric__title",a).textContent=e.result.title;const i=this.dom.find(".lh-metric__value",a);i.textContent=e.result.displayValue||"";const o=this.dom.find(".lh-metric__description",a);if(o.append(this.dom.convertMarkdownLinkSnippets(e.result.description)),"error"===e.result.scoreDisplayMode){o.textContent="",i.textContent="Error!";this.dom.createChildOf(o,"span").textContent=e.result.errorMessage||"Report error: no metric information"}else"notApplicable"===e.result.scoreDisplayMode&&(i.textContent="--");return n}_renderOpportunity(e,a){const n=this.dom.createComponent("opportunity"),t=this.populateAuditValues(e,n);if(t.id=e.result.id,!e.result.details||"error"===e.result.scoreDisplayMode)return t;const i=e.result.details;if("opportunity"!==i.type)return t;const o=this.dom.find("span.lh-audit__display-text, div.lh-audit__display-text",t),r=i.overallSavingsMs/a*100+"%";if(this.dom.find("div.lh-sparkline__bar",t).style.width=r,o.textContent=de.i18n.formatSeconds(i.overallSavingsMs,.01),e.result.displayValue){const a=e.result.displayValue;this.dom.find("div.lh-load-opportunity__sparkline",t).title=a,o.title=a}return t}_getWastedMs(e){if(e.result.details&&"opportunity"===e.result.details.type){const a=e.result.details;if("number"!=typeof a.overallSavingsMs)throw new Error("non-opportunity details passed to _getWastedMs");return a.overallSavingsMs}return Number.MIN_VALUE}_getScoringCalculatorHref(e){const a=e.filter((e=>"metrics"===e.group)),n=e.find((e=>"interactive"===e.id)),t=e.find((e=>"first-cpu-idle"===e.id)),i=e.find((e=>"first-meaningful-paint"===e.id));n&&a.push(n),t&&a.push(t),i&&a.push(i);const o=[...a.map((e=>{let a;var n;return"number"==typeof e.result.numericValue?(a="cumulative-layout-shift"===e.id?(n=e.result.numericValue,Math.round(100*n)/100):Math.round(e.result.numericValue),a=a.toString()):a="null",[e.acronym||e.id,a]}))];de.reportJson&&(o.push(["device",de.reportJson.configSettings.formFactor]),o.push(["version",de.reportJson.lighthouseVersion]));const r=new URLSearchParams(o),s=new URL("https://googlechrome.github.io/lighthouse/scorecalc/");return s.hash=r.toString(),s.href}_classifyPerformanceAudit(e){return e.group?null:e.result.details&&"opportunity"===e.result.details.type?"load-opportunity":"diagnostic"}render(e,a,n){const t=de.i18n.strings,i=this.dom.createElement("div","lh-category");i.id=e.id,i.append(this.renderCategoryHeader(e,a,n));const o=e.auditRefs.filter((e=>"metrics"===e.group));if(o.length){const[n,r]=this.renderAuditGroup(a.metrics),s=this.dom.createElement("input","lh-metrics-toggle__input"),l=`lh-metrics-toggle${de.getUniqueSuffix()}`;s.setAttribute("aria-label","Toggle the display of metric descriptions"),s.type="checkbox",s.id=l,n.prepend(s);const p=this.dom.find(".lh-audit-group__header",n),u=this.dom.createChildOf(p,"label","lh-metrics-toggle__label");u.htmlFor=l;const c=this.dom.createChildOf(u,"span","lh-metrics-toggle__labeltext--show"),d=this.dom.createChildOf(u,"span","lh-metrics-toggle__labeltext--hide");c.textContent=de.i18n.strings.expandView,d.textContent=de.i18n.strings.collapseView;const m=this.dom.createElement("div","lh-metrics-container");if(n.insertBefore(m,r),o.forEach((e=>{m.append(this._renderMetric(e))})),i.querySelector(".lh-gauge__wrapper")){const a=this.dom.find(".lh-category-header__description",i),n=this.dom.createChildOf(a,"div","lh-metrics__disclaimer"),o=this.dom.convertMarkdownLinkSnippets(t.varianceDisclaimer);n.append(o);const r=this.dom.createChildOf(n,"a","lh-calclink");r.target="_blank",r.textContent=t.calculatorLink,this.dom.safelySetHref(r,this._getScoringCalculatorHref(e.auditRefs))}n.classList.add("lh-audit-group--metrics"),i.append(n)}const r=this.dom.createChildOf(i,"div","lh-filmstrip-container"),s=e.auditRefs.find((e=>"screenshot-thumbnails"===e.id))?.result;if(s?.details){r.id=s.id;const e=this.detailsRenderer.render(s.details);e&&r.append(e)}const l=e.auditRefs.filter((e=>"load-opportunity"===this._classifyPerformanceAudit(e))).filter((e=>!de.showAsPassed(e.result))).sort(((e,a)=>this._getWastedMs(a)-this._getWastedMs(e))),p=o.filter((e=>!!e.relevantAudits));if(p.length&&this.renderMetricAuditFilter(p,i),l.length){const e=2e3,n=l.map((e=>this._getWastedMs(e))),o=Math.max(...n),r=Math.max(1e3*Math.ceil(o/1e3),e),[s,p]=this.renderAuditGroup(a["load-opportunities"]),u=this.dom.createComponent("opportunityHeader");this.dom.find(".lh-load-opportunity__col--one",u).textContent=t.opportunityResourceColumnLabel,this.dom.find(".lh-load-opportunity__col--two",u).textContent=t.opportunitySavingsColumnLabel;const c=this.dom.find(".lh-load-opportunity__header",u);s.insertBefore(c,p),l.forEach((e=>s.insertBefore(this._renderOpportunity(e,r),p))),s.classList.add("lh-audit-group--load-opportunities"),i.append(s)}const u=e.auditRefs.filter((e=>"diagnostic"===this._classifyPerformanceAudit(e))).filter((e=>!de.showAsPassed(e.result))).sort(((e,a)=>("informative"===e.result.scoreDisplayMode?100:Number(e.result.score))-("informative"===a.result.scoreDisplayMode?100:Number(a.result.score))));if(u.length){const[e,n]=this.renderAuditGroup(a.diagnostics);u.forEach((a=>e.insertBefore(this.renderAudit(a),n))),e.classList.add("lh-audit-group--diagnostics"),i.append(e)}const c=e.auditRefs.filter((e=>this._classifyPerformanceAudit(e)&&de.showAsPassed(e.result)));if(!c.length)return i;const d={auditRefs:c,groupDefinitions:a},m=this.renderClump("passed",d);i.append(m);const h=[];if(["performance-budget","timing-budget"].forEach((a=>{const n=e.auditRefs.find((e=>e.id===a));if(n?.result.details){const e=this.detailsRenderer.render(n.result.details);e&&(e.id=a,e.classList.add("lh-details","lh-details--budget","lh-audit"),h.push(e))}})),h.length>0){const[e,n]=this.renderAuditGroup(a.budgets);h.forEach((a=>e.insertBefore(a,n))),e.classList.add("lh-audit-group--budgets"),i.append(e)}return i}renderMetricAuditFilter(e,a){const n=this.dom.createElement("div","lh-metricfilter");this.dom.createChildOf(n,"span","lh-metricfilter__text").textContent=de.i18n.strings.showRelevantAudits;const t=[{acronym:"All"},...e],i=de.getUniqueSuffix();for(const e of t){const t=`metric-${e.acronym}-${i}`,o=this.dom.createChildOf(n,"input","lh-metricfilter__radio");o.type="radio",o.name=`metricsfilter-${i}`,o.id=t;const r=this.dom.createChildOf(n,"label","lh-metricfilter__label");r.htmlFor=t,r.title=e.result?.title,r.textContent=e.acronym||e.id,"All"===e.acronym&&(o.checked=!0,r.classList.add("lh-metricfilter__label--active")),a.append(n),o.addEventListener("input",(n=>{for(const e of a.querySelectorAll("label.lh-metricfilter__label"))e.classList.toggle("lh-metricfilter__label--active",e.htmlFor===t);a.classList.toggle("lh-category--filtered","All"!==e.acronym);for(const n of a.querySelectorAll("div.lh-audit"))"All"!==e.acronym?(n.hidden=!0,e.relevantAudits&&e.relevantAudits.includes(n.id)&&(n.hidden=!1)):n.hidden=!1;const i=a.querySelectorAll("div.lh-audit-group, details.lh-audit-group");for(const e of i){e.hidden=!1;const a=Array.from(e.querySelectorAll("div.lh-audit")),n=!!a.length&&a.every((e=>e.hidden));e.hidden=n}}))}}}
 /**
    * @license
    * Copyright 2018 The Lighthouse Authors. All Rights Reserved.