lighthouse 9.6.8 → 10.0.0-dev.20230210

package/lighthouse-core/audits/performance-budget.js

@@ -1,154 +0,0 @@
-/**
- * @license Copyright 2019 The Lighthouse Authors. All Rights Reserved.
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, 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.
- */
-'use strict';
-
-const Audit = require('./audit.js');
-const ResourceSummary = require('../computed/resource-summary.js');
-const MainResource = require('../computed/main-resource.js');
-const Budget = require('../config/budget.js');
-const i18n = require('../lib/i18n/i18n.js');
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that compares the size and quantity of page resources against targets set by the user. These targets are thought of as "performance budgets" because these metrics impact page performance (i.e. how quickly a page loads). */
-  title: 'Performance budget',
-  /** Description of a Lighthouse audit where a user sets budgets for the quantity and size of page resources. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Keep the quantity and size of network requests under the targets ' +
-    'set by the provided performance budget. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/budgets).',
-  /** [ICU Syntax] Entry in a data table identifying the number of network requests of a particular type. Count will be a whole number. String should be as short as possible to be able to fit well into the table. */
-  requestCountOverBudget: `{count, plural,
-    =1 {1 request}
-    other {# requests}
-   }`,
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/** @typedef {import('../computed/resource-summary.js').ResourceEntry} ResourceEntry */
-/** @typedef {{resourceType: LH.Budget.ResourceType, label: LH.IcuMessage, requestCount: number, transferSize: number, sizeOverBudget: number | undefined, countOverBudget: LH.IcuMessage | undefined}} BudgetItem */
-
-class ResourceBudget extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'performance-budget',
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-      scoreDisplayMode: Audit.SCORING_MODES.INFORMATIVE,
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['devtoolsLogs', 'URL'],
-    };
-  }
-
-  /**
-   * @param {LH.Budget.ResourceType} resourceType
-   * @return {string}
-   */
-  static getRowLabel(resourceType) {
-    /** @type {Record<LH.Budget.ResourceType,string>} */
-    const strMappings = {
-      'total': i18n.UIStrings.totalResourceType,
-      'document': i18n.UIStrings.documentResourceType,
-      'script': i18n.UIStrings.scriptResourceType,
-      'stylesheet': i18n.UIStrings.stylesheetResourceType,
-      'image': i18n.UIStrings.imageResourceType,
-      'media': i18n.UIStrings.mediaResourceType,
-      'font': i18n.UIStrings.fontResourceType,
-      'other': i18n.UIStrings.otherResourceType,
-      'third-party': i18n.UIStrings.thirdPartyResourceType,
-    };
-    return strMappings[resourceType];
-  }
-
-  /**
-   * @param {Immutable<LH.Budget>} budget
-   * @param {Record<LH.Budget.ResourceType, ResourceEntry>} summary
-   * @return {Array<BudgetItem>}
-   */
-  static tableItems(budget, summary) {
-    const resourceTypes = /** @type {Array<LH.Budget.ResourceType>} */ (Object.keys(summary));
-    return resourceTypes.map((resourceType) => {
-      const label = str_(this.getRowLabel(resourceType));
-      const requestCount = summary[resourceType].count;
-      const transferSize = summary[resourceType].transferSize;
-
-      let sizeOverBudget;
-      let countOverBudget;
-
-      if (budget.resourceSizes) {
-        const sizeBudget = budget.resourceSizes.find(b => b.resourceType === resourceType);
-        if (sizeBudget && (transferSize > (sizeBudget.budget * 1024))) {
-          sizeOverBudget = transferSize - (sizeBudget.budget * 1024);
-        }
-      }
-      if (budget.resourceCounts) {
-        const countBudget = budget.resourceCounts.find(b => b.resourceType === resourceType);
-        if (countBudget && (requestCount > countBudget.budget)) {
-          const requestDifference = requestCount - countBudget.budget;
-          countOverBudget = str_(UIStrings.requestCountOverBudget, {count: requestDifference});
-        }
-      }
-      return {
-        resourceType,
-        label,
-        requestCount,
-        transferSize,
-        countOverBudget,
-        sizeOverBudget,
-      };
-    }).filter((row) => {
-      // Only resources with budgets should be included in the table
-      if (budget.resourceSizes) {
-        if (budget.resourceSizes.some(b => b.resourceType === row.resourceType)) return true;
-      }
-      if (budget.resourceCounts) {
-        if (budget.resourceCounts.some(b => b.resourceType === row.resourceType)) return true;
-      }
-      return false;
-    }).sort((a, b) => {
-      return (b.sizeOverBudget || 0) - (a.sizeOverBudget || 0);
-    });
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    const data = {devtoolsLog, URL: artifacts.URL, budgets: context.settings.budgets};
-    const summary = await ResourceSummary.request(data, context);
-    const mainResource = await MainResource.request({URL: artifacts.URL, devtoolsLog}, context);
-    const budget = Budget.getMatchingBudget(context.settings.budgets, mainResource.url);
-
-    if (!budget) {
-      return {
-        score: 0,
-        notApplicable: true,
-      };
-    }
-
-    /** @type {LH.Audit.Details.Table['headings']} */
-    const headers = [
-      {key: 'label', itemType: 'text', text: str_(i18n.UIStrings.columnResourceType)},
-      {key: 'requestCount', itemType: 'numeric', text: str_(i18n.UIStrings.columnRequests)},
-      {key: 'transferSize', itemType: 'bytes', text: str_(i18n.UIStrings.columnTransferSize)},
-      {key: 'countOverBudget', itemType: 'text', text: ''},
-      {key: 'sizeOverBudget', itemType: 'bytes', text: str_(i18n.UIStrings.columnOverBudget)},
-    ];
-
-    return {
-      details: Audit.makeTableDetails(headers,
-        this.tableItems(budget, summary)),
-      score: 1,
-    };
-  }
-}
-
-module.exports = ResourceBudget;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/predictive-perf.js

@@ -1,101 +0,0 @@
-/**
- * @license Copyright 2017 The Lighthouse Authors. All Rights Reserved.
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, 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.
- */
-'use strict';
-
-const Audit = require('./audit.js');
-const i18n = require('../lib/i18n/i18n.js');
-
-const LanternFcp = require('../computed/metrics/lantern-first-contentful-paint.js');
-const LanternFmp = require('../computed/metrics/lantern-first-meaningful-paint.js');
-const LanternInteractive = require('../computed/metrics/lantern-interactive.js');
-const LanternSpeedIndex = require('../computed/metrics/lantern-speed-index.js');
-const LanternLcp = require('../computed/metrics/lantern-largest-contentful-paint.js');
-
-// Parameters (in ms) for log-normal CDF scoring. To see the curve:
-//   https://www.desmos.com/calculator/bksgkihhj8
-const SCORING_P10 = 3651;
-const SCORING_MEDIAN = 10000;
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, {});
-
-class PredictivePerf extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'predictive-perf',
-      title: 'Predicted Performance (beta)',
-      description:
-        'Predicted performance evaluates how your site will perform under ' +
-        'a cellular connection on a mobile device.',
-      scoreDisplayMode: Audit.SCORING_MODES.NUMERIC,
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['traces', 'devtoolsLogs', 'GatherContext'],
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const gatherContext = artifacts.GatherContext;
-    const trace = artifacts.traces[Audit.DEFAULT_PASS];
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    /** @type {LH.Config.Settings} */
-    // @ts-expect-error - TODO(bckenny): allow optional `throttling` settings
-    const settings = {}; // Use default settings.
-    const computationData = {trace, devtoolsLog, gatherContext, settings};
-    const fcp = await LanternFcp.request(computationData, context);
-    const fmp = await LanternFmp.request(computationData, context);
-    const tti = await LanternInteractive.request(computationData, context);
-    const si = await LanternSpeedIndex.request(computationData, context);
-    const lcp = await LanternLcp.request(computationData, context);
-
-    const values = {
-      roughEstimateOfFCP: fcp.timing,
-      optimisticFCP: fcp.optimisticEstimate.timeInMs,
-      pessimisticFCP: fcp.pessimisticEstimate.timeInMs,
-
-      roughEstimateOfFMP: fmp.timing,
-      optimisticFMP: fmp.optimisticEstimate.timeInMs,
-      pessimisticFMP: fmp.pessimisticEstimate.timeInMs,
-
-      roughEstimateOfTTI: tti.timing,
-      optimisticTTI: tti.optimisticEstimate.timeInMs,
-      pessimisticTTI: tti.pessimisticEstimate.timeInMs,
-
-      roughEstimateOfSI: si.timing,
-      optimisticSI: si.optimisticEstimate.timeInMs,
-      pessimisticSI: si.pessimisticEstimate.timeInMs,
-
-      roughEstimateOfLCP: lcp.timing,
-      optimisticLCP: lcp.optimisticEstimate.timeInMs,
-      pessimisticLCP: lcp.pessimisticEstimate.timeInMs,
-    };
-
-    const score = Audit.computeLogNormalScore(
-      {p10: SCORING_P10, median: SCORING_MEDIAN},
-      values.roughEstimateOfTTI
-    );
-
-    return {
-      score,
-      numericValue: values.roughEstimateOfTTI,
-      numericUnit: 'millisecond',
-      displayValue: str_(i18n.UIStrings.ms, {timeInMs: values.roughEstimateOfTTI}),
-      details: {
-        type: 'debugdata',
-        // TODO: Consider not nesting values under `items`.
-        items: [values],
-      },
-    };
-  }
-}
-
-module.exports = PredictivePerf;

package/lighthouse-core/audits/preload-fonts.js

@@ -1,107 +0,0 @@
-/**
- * @license Copyright 2020 The Lighthouse Authors. All Rights Reserved.
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, 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.
- */
-'use strict';
-
-/**
- * @fileoverview
- * Audit that checks whether fonts that use `font-display: optional` were preloaded.
- */
-
-const Audit = require('./audit.js');
-const i18n = require('./../lib/i18n/i18n.js');
-const FontDisplay = require('./../audits/font-display.js');
-const PASSING_FONT_DISPLAY_REGEX = /^(optional)$/;
-const NetworkRecords = require('../computed/network-records.js');
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that provides detail on whether fonts that used `font-display: optional` were preloaded. This descriptive title is shown to users when all fonts that used `font-display: optional` were preloaded. */
-  title: 'Fonts with `font-display: optional` are preloaded',
-  /** Title of a Lighthouse audit that provides detail on whether fonts that used `font-display: optional` were preloaded. This descriptive title is shown to users when one or more fonts used `font-display: optional` and were not preloaded. */
-  failureTitle: 'Fonts with `font-display: optional` are not preloaded',
-  /** Description of a Lighthouse audit that tells the user why they should preload fonts if they are using `font-display: optional`. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Preload `optional` fonts so first-time visitors may use them. [Learn more](https://web.dev/preload-optional-fonts/)',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-class PreloadFontsAudit extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'preload-fonts',
-      title: str_(UIStrings.title),
-      failureTitle: str_(UIStrings.failureTitle),
-      description: str_(UIStrings.description),
-      requiredArtifacts: ['devtoolsLogs', 'URL', 'CSSUsage'],
-    };
-  }
-
-  /**
-   * Finds which font URLs were attempted to be preloaded,
-   * ignoring those that failed to be reused and were requested again.
-   * Note: document.fonts.load() is a valid way to preload fonts,
-   * but we are not currently checking for that.
-   * @param {Array<LH.Artifacts.NetworkRequest>} networkRecords
-   * @return {Set<string>}
-   */
-  static getURLsAttemptedToPreload(networkRecords) {
-    const attemptedURLs = networkRecords
-      .filter(req => req.resourceType === 'Font')
-      .filter(req => req.isLinkPreload)
-      .map(req => req.url);
-
-    return new Set(attemptedURLs);
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit_(artifacts, context) {
-    const devtoolsLog = artifacts.devtoolsLogs[this.DEFAULT_PASS];
-    const networkRecords = await NetworkRecords.request(devtoolsLog, context);
-
-    // Gets the URLs of fonts where font-display: optional.
-    const optionalFontURLs =
-      FontDisplay.findFontDisplayDeclarations(artifacts, PASSING_FONT_DISPLAY_REGEX).passingURLs;
-
-    // Gets the URLs of fonts attempted to be preloaded.
-    const preloadedFontURLs =
-      PreloadFontsAudit.getURLsAttemptedToPreload(networkRecords);
-
-    const results = Array.from(optionalFontURLs)
-      .filter(url => !preloadedFontURLs.has(url))
-      .map(url => {
-        return {url};
-      });
-
-    /** @type {LH.Audit.Details.Table['headings']} */
-    const headings = [
-      {key: 'url', itemType: 'url', text: str_(i18n.UIStrings.columnURL)},
-    ];
-
-    return {
-      score: results.length > 0 ? 0 : 1,
-      details: Audit.makeTableDetails(headings, results),
-      notApplicable: optionalFontURLs.size === 0,
-    };
-  }
-
-  /**
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit() {
-    // Preload advice is on hold until https://github.com/GoogleChrome/lighthouse/issues/11960
-    // is resolved.
-    return {score: 1, notApplicable: true};
-  }
-}
-
-module.exports = PreloadFontsAudit;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/preload-lcp-image.js

@@ -1,272 +0,0 @@
-/**
- * @license Copyright 2020 The Lighthouse Authors. All Rights Reserved.
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, 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.
- */
-'use strict';
-
-const Audit = require('./audit.js');
-const i18n = require('../lib/i18n/i18n.js');
-const NetworkRequest = require('../lib/network-request.js');
-const MainResource = require('../computed/main-resource.js');
-const LanternLCP = require('../computed/metrics/lantern-largest-contentful-paint.js');
-const LoadSimulator = require('../computed/load-simulator.js');
-const UnusedBytes = require('./byte-efficiency/byte-efficiency-audit.js');
-
-const UIStrings = {
-  /** Title of a lighthouse audit that tells a user to preload an image in order to improve their LCP time. */
-  title: 'Preload Largest Contentful Paint image',
-  /** Description of a lighthouse audit that tells a user to preload an image in order to improve their LCP time.  */
-  description: 'Preload the image used by ' +
-    'the LCP element in order to improve your LCP time. [Learn more](https://web.dev/optimize-lcp/#preload-important-resources).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @typedef {Array<{url: string, initiatorType: string}>} InitiatorPath
- */
-
-class PreloadLCPImageAudit extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'preload-lcp-image',
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['traces', 'devtoolsLogs', 'GatherContext', 'URL', 'TraceElements',
-        'ImageElements'],
-      scoreDisplayMode: Audit.SCORING_MODES.NUMERIC,
-    };
-  }
-
-  /**
-   *
-   * @param {LH.Artifacts.NetworkRequest} request
-   * @param {LH.Artifacts.NetworkRequest} mainResource
-   * @param {Array<LH.Gatherer.Simulation.GraphNode>} initiatorPath
-   * @return {boolean}
-   */
-  static shouldPreloadRequest(request, mainResource, initiatorPath) {
-    const mainResourceDepth = mainResource.redirects ? mainResource.redirects.length : 0;
-
-    // If it's already preloaded, no need to recommend it.
-    if (request.isLinkPreload) return false;
-    // It's not a request loaded over the network, don't recommend it.
-    if (NetworkRequest.isNonNetworkRequest(request)) return false;
-    // It's already discoverable from the main document, don't recommend it.
-    if (initiatorPath.length <= mainResourceDepth) return false;
-    // Finally, return whether or not it belongs to the main frame
-    return request.frameId === mainResource.frameId;
-  }
-
-  /**
-   * @param {LH.Gatherer.Simulation.GraphNode} graph
-   * @param {string} imageUrl
-   * @return {{lcpNode: LH.Gatherer.Simulation.GraphNetworkNode|undefined, path: Array<LH.Gatherer.Simulation.GraphNetworkNode>|undefined}}
-   */
-  static findLCPNode(graph, imageUrl) {
-    let lcpNode;
-    let path;
-    graph.traverse((node, traversalPath) => {
-      if (node.type !== 'network') return;
-      if (node.record.url === imageUrl) {
-        lcpNode = node;
-        path =
-          traversalPath.slice(1).filter(initiator => initiator.type === 'network');
-      }
-    });
-    return {
-      lcpNode,
-      path,
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts.NetworkRequest} mainResource
-   * @param {LH.Gatherer.Simulation.GraphNode} graph
-   * @param {LH.Artifacts.TraceElement} lcpElement
-   * @param {Array<LH.Artifacts.ImageElement>} imageElements
-   * @return {{lcpNodeToPreload?: LH.Gatherer.Simulation.GraphNetworkNode, initiatorPath?: InitiatorPath}}
-   */
-  static getLCPNodeToPreload(mainResource, graph, lcpElement, imageElements) {
-    if (!lcpElement) return {};
-
-    const lcpImageElement = imageElements.find(elem => {
-      return elem.node.devtoolsNodePath === lcpElement.node.devtoolsNodePath;
-    });
-
-    if (!lcpImageElement) return {};
-    const lcpUrl = lcpImageElement.src;
-    const {lcpNode, path} = PreloadLCPImageAudit.findLCPNode(graph, lcpUrl);
-    if (!lcpNode || !path) return {};
-
-    // eslint-disable-next-line max-len
-    const shouldPreload = PreloadLCPImageAudit.shouldPreloadRequest(lcpNode.record, mainResource, path);
-    const lcpNodeToPreload = shouldPreload ? lcpNode : undefined;
-
-    const initiatorPath = [
-      {url: lcpNode.record.url, initiatorType: lcpNode.initiatorType},
-      ...path.map(n => ({url: n.record.url, initiatorType: n.initiatorType})),
-    ];
-
-    return {
-      lcpNodeToPreload,
-      initiatorPath,
-    };
-  }
-
-  /**
-   * Computes the estimated effect of preloading the LCP image.
-   * @param {LH.Artifacts.TraceElement} lcpElement
-   * @param {LH.Gatherer.Simulation.GraphNetworkNode|undefined} lcpNode
-   * @param {LH.Gatherer.Simulation.GraphNode} graph
-   * @param {LH.Gatherer.Simulation.Simulator} simulator
-   * @return {{wastedMs: number, results: Array<{node: LH.Audit.Details.NodeValue, url: string, wastedMs: number}>}}
-   */
-  static computeWasteWithGraph(lcpElement, lcpNode, graph, simulator) {
-    if (!lcpNode) {
-      return {
-        wastedMs: 0,
-        results: [],
-      };
-    }
-
-    const modifiedGraph = graph.cloneWithRelationships();
-
-    // Store the IDs of the LCP Node's dependencies for later
-    /** @type {Set<string>} */
-    const dependenciesIds = new Set();
-    for (const node of lcpNode.getDependencies()) {
-      dependenciesIds.add(node.id);
-    }
-
-    /** @type {LH.Gatherer.Simulation.GraphNode|null} */
-    let modifiedLCPNode = null;
-    /** @type {LH.Gatherer.Simulation.GraphNode|null} */
-    let mainDocumentNode = null;
-
-    for (const {node} of modifiedGraph.traverseGenerator()) {
-      if (node.type !== 'network') continue;
-
-      if (node.isMainDocument()) {
-        mainDocumentNode = node;
-      } else if (node.id === lcpNode.id) {
-        modifiedLCPNode = node;
-      }
-    }
-
-    if (!mainDocumentNode) {
-      // Should always find the main document node
-      throw new Error('Could not find main document node');
-    }
-
-    if (!modifiedLCPNode) {
-      // Should always find the LCP node as well or else this function wouldn't have been called
-      throw new Error('Could not find the LCP node');
-    }
-
-    // Preload will request the resource as soon as its discovered in the main document.
-    // Reflect this change in the dependencies in our modified graph.
-    modifiedLCPNode.removeAllDependencies();
-    modifiedLCPNode.addDependency(mainDocumentNode);
-
-    const simulationBeforeChanges = simulator.simulate(graph, {flexibleOrdering: true});
-    const simulationAfterChanges = simulator.simulate(modifiedGraph, {flexibleOrdering: true});
-    const lcpTimingsBefore = simulationBeforeChanges.nodeTimings.get(lcpNode);
-    if (!lcpTimingsBefore) throw new Error('Impossible - node timings should never be undefined');
-    const lcpTimingsAfter = simulationAfterChanges.nodeTimings.get(modifiedLCPNode);
-    if (!lcpTimingsAfter) throw new Error('Impossible - node timings should never be undefined');
-    /** @type {Map<String, LH.Gatherer.Simulation.GraphNode>} */
-    const modifiedNodesById = Array.from(simulationAfterChanges.nodeTimings.keys())
-      .reduce((map, node) => map.set(node.id, node), new Map());
-
-    // Even with preload, the image can't be painted before it's even inserted into the DOM.
-    // New LCP time will be the max of image download and image in DOM (endTime of its deps).
-    let maxDependencyEndTime = 0;
-    for (const nodeId of Array.from(dependenciesIds)) {
-      const node = modifiedNodesById.get(nodeId);
-      if (!node) throw new Error('Impossible - node should never be undefined');
-      const timings = simulationAfterChanges.nodeTimings.get(node);
-      const endTime = timings?.endTime || 0;
-      maxDependencyEndTime = Math.max(maxDependencyEndTime, endTime);
-    }
-
-    const wastedMs = lcpTimingsBefore.endTime -
-      Math.max(lcpTimingsAfter.endTime, maxDependencyEndTime);
-
-    return {
-      wastedMs,
-      results: [{
-        node: Audit.makeNodeItem(lcpElement.node),
-        url: lcpNode.record.url,
-        wastedMs,
-      }],
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const gatherContext = artifacts.GatherContext;
-    const trace = artifacts.traces[PreloadLCPImageAudit.DEFAULT_PASS];
-    const devtoolsLog = artifacts.devtoolsLogs[PreloadLCPImageAudit.DEFAULT_PASS];
-    const URL = artifacts.URL;
-    const metricData = {trace, devtoolsLog, gatherContext, settings: context.settings};
-    const lcpElement = artifacts.TraceElements
-      .find(element => element.traceEventType === 'largest-contentful-paint');
-
-    if (!lcpElement || lcpElement.type !== 'image') {
-      return {score: null, notApplicable: true};
-    }
-
-    const [mainResource, lanternLCP, simulator] = await Promise.all([
-      MainResource.request({devtoolsLog, URL}, context),
-      LanternLCP.request(metricData, context),
-      LoadSimulator.request({devtoolsLog, settings: context.settings}, context),
-    ]);
-
-    const graph = lanternLCP.pessimisticGraph;
-    // eslint-disable-next-line max-len
-    const {lcpNodeToPreload, initiatorPath} = PreloadLCPImageAudit.getLCPNodeToPreload(mainResource, graph, lcpElement, artifacts.ImageElements);
-
-    const {results, wastedMs} =
-      PreloadLCPImageAudit.computeWasteWithGraph(lcpElement, lcpNodeToPreload, graph, simulator);
-
-    /** @type {LH.Audit.Details.Opportunity['headings']} */
-    const headings = [
-      {key: 'node', valueType: 'node', label: ''},
-      {key: 'url', valueType: 'url', label: str_(i18n.UIStrings.columnURL)},
-      {key: 'wastedMs', valueType: 'timespanMs', label: str_(i18n.UIStrings.columnWastedMs)},
-    ];
-    const details = Audit.makeOpportunityDetails(headings, results, wastedMs);
-
-    // If LCP element was an image and had valid network records (regardless of
-    // if it should be preloaded), it will be found first in the `initiatorPath`.
-    // Otherwise path and length will be undefined.
-    if (initiatorPath) {
-      details.debugData = {
-        type: 'debugdata',
-        initiatorPath,
-        pathLength: initiatorPath.length,
-      };
-    }
-
-    return {
-      score: UnusedBytes.scoreForWastedMs(wastedMs),
-      numericValue: wastedMs,
-      numericUnit: 'millisecond',
-      displayValue: wastedMs ? str_(i18n.UIStrings.displayValueMsSavings, {wastedMs}) : '',
-      details,
-    };
-  }
-}
-
-module.exports = PreloadLCPImageAudit;
-module.exports.UIStrings = UIStrings;