lighthouse 12.8.2-dev.20251004 → 12.8.2-dev.20251006

package/core/audits/uses-rel-preconnect.js

@@ -1,286 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import {Audit} from './audit.js';
-import UrlUtils from '../lib/url-utils.js';
-import * as i18n from '../lib/i18n/i18n.js';
-import {NetworkRecords} from '../computed/network-records.js';
-import {MainResource} from '../computed/main-resource.js';
-import {LoadSimulator} from '../computed/load-simulator.js';
-import {ProcessedNavigation} from '../computed/processed-navigation.js';
-import {PageDependencyGraph} from '../computed/page-dependency-graph.js';
-import {LanternLargestContentfulPaint} from '../computed/metrics/lantern-largest-contentful-paint.js';
-import {LanternFirstContentfulPaint} from '../computed/metrics/lantern-first-contentful-paint.js';
-
-// Preconnect establishes a "clean" socket. Chrome's socket manager will keep an unused socket
-// around for 10s. Meaning, the time delta between processing preconnect a request should be <10s,
-// otherwise it's wasted. We add a 5s margin so we are sure to capture all key requests.
-// @see https://github.com/GoogleChrome/lighthouse/issues/3106#issuecomment-333653747
-const PRECONNECT_SOCKET_MAX_IDLE_IN_MS = 15_000;
-
-const IGNORE_THRESHOLD_IN_MS = 50;
-
-const UIStrings = {
-  /** Imperative title of a Lighthouse audit that tells the user to connect early to internet domains that will be used to load page resources. Origin is the correct term, however 'domain name' could be used if neccsesary. This is displayed in a list of audit titles that Lighthouse generates. */
-  title: 'Preconnect to required origins',
-  /** Description of a Lighthouse audit that tells the user how to connect early to third-party domains that will be used to load page resources. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
-  description:
-    'Consider adding `preconnect` or `dns-prefetch` resource hints to establish early ' +
-    'connections to important third-party origins. ' +
-    '[Learn how to preconnect to required origins](https://developer.chrome.com/docs/lighthouse/performance/uses-rel-preconnect/).',
-  /**
-   * @description A warning message that is shown when the user tried to follow the advice of the audit, but it's not working as expected.
-   * @example {https://example.com} securityOrigin
-   * */
-  unusedWarning: 'A `<link rel=preconnect>` was found for "{securityOrigin}" but was not used ' +
-    'by the browser. Only use `preconnect` for important origins ' +
-    'that the page will certainly request.',
-  /**
-   * @description A warning message that is shown when the user tried to follow the advice of the audit, but it's not working as expected. Forgetting to set the `crossorigin` HTML attribute, or setting it to an incorrect value, on the link is a common mistake when adding preconnect links.
-   * @example {https://example.com} securityOrigin
-   * */
-  crossoriginWarning: 'A `<link rel=preconnect>` was found for "{securityOrigin}" but was not ' +
-    'used by the browser. Check that you are using the `crossorigin` attribute properly.',
-  /** A warning message that is shown when found more than 2 preconnected links */
-  tooManyPreconnectLinksWarning: 'More than 2 `<link rel=preconnect>` connections were found. ' +
-   'These should be used sparingly and only to the most important origins.',
-};
-
-const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
-
-class UsesRelPreconnectAudit extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'uses-rel-preconnect',
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-      supportedModes: ['navigation'],
-      guidanceLevel: 3,
-      requiredArtifacts: ['Trace', 'DevtoolsLog', 'URL', 'LinkElements', 'SourceMaps'],
-      scoreDisplayMode: Audit.SCORING_MODES.METRIC_SAVINGS,
-    };
-  }
-
-  /**
-   * Check if record has valid timing
-   * @param {LH.Artifacts.NetworkRequest} record
-   * @return {boolean}
-   */
-  static hasValidTiming(record) {
-    return !!record.timing && record.timing.connectEnd >= 0 && record.timing.connectStart >= 0;
-  }
-
-  /**
-   * Check is the connection is already open
-   * @param {LH.Artifacts.NetworkRequest} record
-   * @return {boolean}
-   */
-  static hasAlreadyConnectedToOrigin(record) {
-    if (!record.timing) return false;
-
-    // When these values are given as -1, that means the page has
-    // a connection for this origin and paid these costs already.
-    if (
-      record.timing.dnsStart === -1 && record.timing.dnsEnd === -1 &&
-      record.timing.connectStart === -1 && record.timing.connectEnd === -1
-    ) {
-      return true;
-    }
-
-    // Less understood: if the connection setup took no time at all, consider
-    // it the same as the above. It is unclear if this is correct, or is even possible.
-    if (
-      record.timing.dnsEnd - record.timing.dnsStart === 0 &&
-      record.timing.connectEnd - record.timing.connectStart === 0
-    ) {
-      return true;
-    }
-
-    return false;
-  }
-
-  /**
-   * Check is the connection has started before the socket idle time
-   * @param {LH.Artifacts.NetworkRequest} record
-   * @param {LH.Artifacts.NetworkRequest} mainResource
-   * @return {boolean}
-   */
-  static socketStartTimeIsBelowThreshold(record, mainResource) {
-    const timeSinceMainEnd = Math.max(0, record.networkRequestTime - mainResource.networkEndTime);
-    return timeSinceMainEnd < PRECONNECT_SOCKET_MAX_IDLE_IN_MS;
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const trace = artifacts.Trace;
-    const devtoolsLog = artifacts.DevtoolsLog;
-    const {URL, SourceMaps} = artifacts;
-    const settings = context.settings;
-
-    let maxWastedLcp = 0;
-    let maxWastedFcp = 0;
-    /** @type {Array<LH.IcuMessage>} */
-    const warnings = [];
-
-    const [networkRecords, mainResource, loadSimulator, processedNavigation, pageGraph] =
-      await Promise.all([
-        NetworkRecords.request(devtoolsLog, context),
-        MainResource.request({devtoolsLog, URL}, context),
-        LoadSimulator.request({devtoolsLog, settings}, context),
-        ProcessedNavigation.request(trace, context),
-        PageDependencyGraph.request(
-          {settings, trace, devtoolsLog, URL, SourceMaps, fromTrace: false}, context),
-      ]);
-
-    const {rtt, additionalRttByOrigin} = loadSimulator.getOptions();
-    const lcpGraph =
-      LanternLargestContentfulPaint.getPessimisticGraph(pageGraph, processedNavigation);
-    /** @type {Set<string>} */
-    const lcpGraphURLs = new Set();
-    lcpGraph.traverse(node => {
-      if (node.type === 'network') lcpGraphURLs.add(node.request.url);
-    });
-
-    const fcpGraph =
-      LanternFirstContentfulPaint.getPessimisticGraph(pageGraph, processedNavigation);
-    const fcpGraphURLs = new Set();
-    fcpGraph.traverse(node => {
-      if (node.type === 'network') fcpGraphURLs.add(node.request.url);
-    });
-
-    /** @type {Map<string, LH.Artifacts.NetworkRequest[]>}  */
-    const origins = new Map();
-    networkRecords
-      .forEach(record => {
-        if (
-          // Filter out all resources where timing info was invalid.
-          !UsesRelPreconnectAudit.hasValidTiming(record) ||
-          // Filter out all resources that are loaded by the document. Connections are already early.
-          record.initiator.url === mainResource.url ||
-          // Filter out urls that do not have an origin (data, file, etc).
-          !record.parsedURL || !record.parsedURL.securityOrigin ||
-          // Filter out all resources that have the same origin. We're already connected.
-          mainResource.parsedURL.securityOrigin === record.parsedURL.securityOrigin ||
-          // Filter out anything that wasn't part of LCP. Only recommend important origins.
-          !lcpGraphURLs.has(record.url) ||
-          // Filter out all resources where origins are already resolved.
-          UsesRelPreconnectAudit.hasAlreadyConnectedToOrigin(record) ||
-          // Make sure the requests are below the PRECONNECT_SOCKET_MAX_IDLE_IN_MS (15s) mark.
-          !UsesRelPreconnectAudit.socketStartTimeIsBelowThreshold(record, mainResource)
-        ) {
-          return;
-        }
-
-        const securityOrigin = record.parsedURL.securityOrigin;
-        const records = origins.get(securityOrigin) || [];
-        records.push(record);
-        origins.set(securityOrigin, records);
-      });
-
-    const preconnectLinks = artifacts.LinkElements.filter(el => el.rel === 'preconnect');
-    const preconnectOrigins =
-      new Set(preconnectLinks.map(link => UrlUtils.getOrigin(link.href || '')));
-
-    /** @type {Array<{url: string, wastedMs: number}>}*/
-    let results = [];
-    origins.forEach(records => {
-      // Sometimes requests are done simultaneous and the connection has not been made
-      // chrome will try to connect for each network record, we get the first record
-      const firstRecordOfOrigin = records.reduce((firstRecord, record) => {
-        return (record.networkRequestTime < firstRecord.networkRequestTime) ? record : firstRecord;
-      });
-
-      // Skip the origin if we don't have timing information
-      if (!firstRecordOfOrigin.timing) return;
-
-      const securityOrigin = firstRecordOfOrigin.parsedURL.securityOrigin;
-
-      // Approximate the connection time with the duration of TCP (+potentially SSL) handshake
-      // DNS time can be large but can also be 0 if a commonly used origin that's cached, so make
-      // no assumption about DNS.
-      const additionalRtt = additionalRttByOrigin.get(securityOrigin) || 0;
-      let connectionTime = rtt + additionalRtt;
-      // TCP Handshake will be at least 2 RTTs for TLS connections
-      if (firstRecordOfOrigin.parsedURL.scheme === 'https') connectionTime = connectionTime * 2;
-
-      const timeBetweenMainResourceAndDnsStart =
-        firstRecordOfOrigin.networkRequestTime -
-        mainResource.networkEndTime +
-        firstRecordOfOrigin.timing.dnsStart;
-
-      const wastedMs = Math.min(connectionTime, timeBetweenMainResourceAndDnsStart);
-      if (wastedMs < IGNORE_THRESHOLD_IN_MS) return;
-
-      if (preconnectOrigins.has(securityOrigin)) {
-        // Add a warning for any origin the user tried to preconnect to but failed
-        warnings.push(str_(UIStrings.crossoriginWarning, {securityOrigin}));
-        return;
-      }
-
-      maxWastedLcp = Math.max(wastedMs, maxWastedLcp);
-
-      if (fcpGraphURLs.has(firstRecordOfOrigin.url)) {
-        maxWastedFcp = Math.max(wastedMs, maxWastedLcp);
-      }
-      results.push({
-        url: securityOrigin,
-        wastedMs: wastedMs,
-      });
-    });
-
-    results = results
-      .sort((a, b) => b.wastedMs - a.wastedMs);
-
-    // Add warnings for any preconnect origins that aren't being used.
-    for (const origin of preconnectOrigins) {
-      if (!origin) continue;
-      if (networkRecords.some(record => origin === record.parsedURL.securityOrigin)) continue;
-      warnings.push(str_(UIStrings.unusedWarning, {securityOrigin: origin}));
-    }
-
-    // Shortcut early with a pass when the user has already configured preconnect.
-    // https://twitter.com/_tbansal/status/1197771385172480001
-    if (preconnectLinks.length >= 2) {
-      return {
-        score: 1,
-        warnings: preconnectLinks.length >= 3 ?
-          [...warnings, str_(UIStrings.tooManyPreconnectLinksWarning)] : warnings,
-        metricSavings: {LCP: maxWastedLcp, FCP: maxWastedFcp},
-      };
-    }
-
-    /** @type {LH.Audit.Details.Opportunity['headings']} */
-    const headings = [
-      {key: 'url', valueType: 'url', label: str_(i18n.UIStrings.columnURL)},
-      {key: 'wastedMs', valueType: 'timespanMs', label: str_(i18n.UIStrings.columnWastedMs)},
-    ];
-
-    const details = Audit.makeOpportunityDetails(headings, results,
-      {overallSavingsMs: maxWastedLcp, sortedBy: ['wastedMs']});
-
-    return {
-      score: results.length ? 0 : 1,
-      numericValue: maxWastedLcp,
-      numericUnit: 'millisecond',
-      displayValue: maxWastedLcp ?
-        str_(i18n.UIStrings.displayValueMsSavings, {wastedMs: maxWastedLcp}) :
-        '',
-      warnings,
-      details,
-      metricSavings: {LCP: maxWastedLcp, FCP: maxWastedFcp},
-    };
-  }
-}
-
-export default UsesRelPreconnectAudit;
-export {UIStrings};

package/core/audits/viewport.d.ts

@@ -1,17 +0,0 @@
-export default Viewport;
-declare class Viewport extends Audit {
-    /**
-     * @param {LH.Artifacts} artifacts
-     * @param {LH.Audit.Context} context
-     * @return {Promise<LH.Audit.Product>}
-     */
-    static audit(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<LH.Audit.Product>;
-}
-export namespace UIStrings {
-    let title: string;
-    let failureTitle: string;
-    let description: string;
-    let explanationNoTag: string;
-}
-import { Audit } from './audit.js';
-//# sourceMappingURL=viewport.d.ts.map

package/core/audits/viewport.js

@@ -1,87 +0,0 @@
-/**
- * @license
- * Copyright 2016 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import {Audit} from './audit.js';
-import {ViewportMeta} from '../computed/viewport-meta.js';
-import * as i18n from '../lib/i18n/i18n.js';
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that provides detail on the viewport meta tag in a web page's html. This descriptive title is shown to users when a viewport tag is set and configured. */
-  title: 'Has a `<meta name="viewport">` tag with `width` or `initial-scale`',
-  /** Title of a Lighthouse audit that provides detail on the viewport meta tag in a web page's html. This descriptive title is shown to users when a viewport tag is not set or configured. */
-  failureTitle: 'Does not have a `<meta name="viewport">` tag with `width` ' +
-    'or `initial-scale`',
-  /** Description of a Lighthouse audit that tells the user why they should have a viewport meta tag in their html. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
-  description: 'A `<meta name="viewport">` not only optimizes your app for mobile screen sizes, ' +
-    'but also prevents [a 300 millisecond delay to user input](https://developer.chrome.com/blog/300ms-tap-delay-gone-away/). ' +
-    '[Learn more about using the viewport meta tag](https://developer.chrome.com/docs/lighthouse/pwa/viewport/).',
-  /** Explanatory message stating that no viewport meta tag exists on the page. */
-  explanationNoTag: 'No `<meta name="viewport">` tag found',
-};
-
-const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
-
-class Viewport extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'viewport',
-      title: str_(UIStrings.title),
-      failureTitle: str_(UIStrings.failureTitle),
-      description: str_(UIStrings.description),
-      guidanceLevel: 3,
-      requiredArtifacts: ['MetaElements'],
-      scoreDisplayMode: Audit.SCORING_MODES.METRIC_SAVINGS,
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const viewportMeta = await ViewportMeta.request(artifacts.MetaElements, context);
-
-    let inpSavings = 300;
-    if (!viewportMeta.hasViewportTag) {
-      return {
-        score: 0,
-        explanation: str_(UIStrings.explanationNoTag),
-        metricSavings: {
-          INP: inpSavings,
-        },
-      };
-    }
-
-    if (viewportMeta.isMobileOptimized) {
-      inpSavings = 0;
-    }
-
-    /** @type {LH.Audit.Details.DebugData|undefined} */
-    let details;
-    if (viewportMeta.rawContentString !== undefined) {
-      details = {
-        type: 'debugdata',
-        viewportContent: viewportMeta.rawContentString,
-      };
-    }
-
-    return {
-      score: Number(viewportMeta.isMobileOptimized),
-      metricSavings: {
-        INP: inpSavings,
-      },
-      warnings: viewportMeta.parserWarnings,
-      details,
-    };
-  }
-}
-
-export default Viewport;
-export {UIStrings};

package/core/audits/work-during-interaction.d.ts

@@ -1,81 +0,0 @@
-export default WorkDuringInteraction;
-export type EventTimingEvent = import("../computed/metrics/responsiveness.js").EventTimingEvent;
-export type TaskNode = import("../lib/tracehouse/main-thread-tasks.js").TaskNode;
-/**
- * @fileoverview This metric gives a high-percentile measure of responsiveness to input.
- */
-declare class WorkDuringInteraction extends Audit {
-    /**
-     * @param {TaskNode} task
-     * @param {TaskNode|undefined} parent
-     * @param {number} startTs
-     * @param {number} endTs
-     * @return {number}
-     */
-    static recursivelyClipTasks(task: TaskNode, parent: TaskNode | undefined, startTs: number, endTs: number): number;
-    /**
-     * Clip the tasks by the start and end points. Take the easy route and drop
-     * to duration 0 if out of bounds, since only durations are needed in the
-     * end (for now).
-     * Assumes owned tasks, so modifies in place. Can be called multiple times on
-     * the same `tasks` because always computed from original event timing.
-     * @param {Array<TaskNode>} tasks
-     * @param {number} startTs
-     * @param {number} endTs
-     */
-    static clipTasksByTs(tasks: Array<TaskNode>, startTs: number, endTs: number): void;
-    /**
-     * @param {EventTimingEvent} interactionEvent
-     */
-    static getPhaseTimes(interactionEvent: EventTimingEvent): {
-        inputDelay: {
-            startTs: number;
-            endTs: number;
-        };
-        processingDuration: {
-            startTs: number;
-            endTs: number;
-        };
-        presentationDelay: {
-            startTs: number;
-            endTs: number;
-        };
-    };
-    /**
-     * @param {EventTimingEvent} interactionEvent
-     * @param {LH.Trace} trace
-     * @param {LH.Artifacts.ProcessedTrace} processedTrace
-     * @param {Array<LH.Artifacts.NetworkRequest>} networkRecords
-     * @return {{table: LH.Audit.Details.Table, phases: Record<string, {startTs: number, endTs: number}>}}
-     */
-    static getThreadBreakdownTable(interactionEvent: EventTimingEvent, trace: LH.Trace, processedTrace: LH.Artifacts.ProcessedTrace, networkRecords: Array<LH.Artifacts.NetworkRequest>): {
-        table: LH.Audit.Details.Table;
-        phases: Record<string, {
-            startTs: number;
-            endTs: number;
-        }>;
-    };
-    /**
-     * @param {LH.Artifacts['TraceElements']} traceElements
-     * @return {LH.Audit.Details.Table | undefined}
-     */
-    static getTraceElementTable(traceElements: LH.Artifacts["TraceElements"]): LH.Audit.Details.Table | undefined;
-    /**
-     * @param {LH.Artifacts} artifacts
-     * @param {LH.Audit.Context} context
-     * @return {Promise<LH.Audit.Product>}
-     */
-    static audit(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<LH.Audit.Product>;
-}
-export namespace UIStrings {
-    let title: string;
-    let failureTitle: string;
-    let description: string;
-    let inputDelay: string;
-    let processingDuration: string;
-    let presentationDelay: string;
-    let displayValue: string;
-    let eventTarget: string;
-}
-import { Audit } from './audit.js';
-//# sourceMappingURL=work-during-interaction.d.ts.map