lighthouse 11.7.0-dev.20240415 → 11.7.0-dev.20240417

package/tsconfig.json

@@ -37,7 +37,6 @@
     "cli/test/fixtures/**/*.js",
     "core/scripts/legacy-javascript/variants",
     // These test files require further changes before they can be type checked.
-    "core/test/config/budget-test.js",
     "core/test/config/config-helpers-test.js",
     "core/test/config/config-plugin-test.js",
     "core/test/config/default-config-test.js",

package/types/artifacts.d.ts

@@ -110,7 +110,7 @@ export interface GathererArtifacts extends PublicGathererArtifacts {
   /** Array of all URLs cached in CacheStorage. */
   CacheContents: string[];
   /** CSS coverage information for styles used by page's final state. */
-  CSSUsage: {rules: Crdp.CSS.RuleUsage[], stylesheets: Artifacts.CSSStyleSheetInfo[]};
+  CSSUsage: Crdp.CSS.RuleUsage[];
   /** The log of devtools protocol activity if there was a page load error and Chrome navigated to a `chrome-error://` page. */
   DevtoolsLogError: DevtoolsLog;
   /** Information on the document's doctype(or null if not present), specifically the name, publicId, and systemId.
@@ -145,6 +145,8 @@ export interface GathererArtifacts extends PublicGathererArtifacts {
   SourceMaps: Array<Artifacts.SourceMap>;
   /** Information on detected tech stacks (e.g. JS libraries) used by the page. */
   Stacks: Artifacts.DetectedStack[];
+  /** CSS stylesheets found on the page. */
+  Stylesheets: Artifacts.CSSStyleSheetInfo[];
   /** The trace if there was a page load error and Chrome navigated to a `chrome-error://` page. */
   TraceError: Trace;
   /** Elements associated with metrics (ie: Largest Contentful Paint element). */

package/types/externs.d.ts

@@ -57,8 +57,6 @@ export interface CliFlags extends Flags {
   precomputedLanternDataPath?: string;
   /** Path to the file where precomputed lantern data should be written to. */
   lanternDataOutputPath?: string;
-  /** Path to the budget.json file for LightWallet. */
-  budgetPath?: string | null;
 
   // The following are given defaults in cli-flags, so are not optional like in Flags or SharedFlagsSettings.
   output: OutputMode[];

package/types/gatherer.d.ts

@@ -49,6 +49,8 @@ declare module Gatherer {
       off(event: 'protocolevent', callback: (payload: Protocol.RawEventMessage) => void): void
     };
     networkMonitor: NetworkMonitor;
+    listenForCrashes: (() => void);
+    fatalRejection: {promise: Promise<never>, rej: (reason: Error) => void}
   }
 
   interface Context<TDependencies extends DependencyKey = DefaultDependenciesKey> {

package/types/lh.d.ts

@@ -7,7 +7,6 @@
 import {ArbitraryEqualityMap as ArbitraryEqualityMap_} from '../core/lib/arbitrary-equality-map.js';
 import * as Artifacts_ from './artifacts.js';
 import Audit_ from './audit.js';
-import Budget_ from './lhr/budget.js';
 import Config_ from './config.js';
 import {Protocol as _Crdp} from 'devtools-protocol/types/protocol.js';
 import {ProtocolMapping as _CrdpMappings} from 'devtools-protocol/types/protocol-mapping.js';
@@ -42,7 +41,6 @@ export import TraceCpuProfile = Artifacts_.TraceCpuProfile;
 export import TraceEvent = Artifacts_.TraceEvent;
 
 export import Audit = Audit_;
-export import Budget = Budget_;
 export import Config = Config_;
 export import Crdp = _Crdp;
 export import CrdpEvents = _CrdpMappings.Events;

package/types/lhr/settings.d.ts

@@ -6,8 +6,6 @@
 
 import type {Protocol as Crdp} from 'devtools-protocol/types/protocol.js';
 
-import Budget from './budget.js';
-
 export type Locale = 'en-US'|'en'|'en-AU'|'en-GB'|'en-IE'|'en-SG'|'en-ZA'|'en-IN'|'ar-XB'|'ar'|'bg'|'ca'|'cs'|'da'|'de'|'el'|'en-XA'|'en-XL'|'es'|'es-419'|'es-AR'|'es-BO'|'es-BR'|'es-BZ'|'es-CL'|'es-CO'|'es-CR'|'es-CU'|'es-DO'|'es-EC'|'es-GT'|'es-HN'|'es-MX'|'es-NI'|'es-PA'|'es-PE'|'es-PR'|'es-PY'|'es-SV'|'es-US'|'es-UY'|'es-VE'|'fi'|'fil'|'fr'|'he'|'hi'|'hr'|'hu'|'gsw'|'id'|'in'|'it'|'iw'|'ja'|'ko'|'lt'|'lv'|'mo'|'nl'|'nb'|'no'|'pl'|'pt'|'pt-PT'|'ro'|'ru'|'sk'|'sl'|'sr'|'sr-Latn'|'sv'|'ta'|'te'|'th'|'tl'|'tr'|'uk'|'vi'|'zh'|'zh-HK'|'zh-TW';
 
 /** Simulation settings that control the amount of network & cpu throttling in the run. */
@@ -109,8 +107,6 @@ export type ScreenEmulationSettings = {
   channel?: string
   /** Precomputed lantern estimates to use instead of observed analysis. */
   precomputedLanternData?: PrecomputedLanternData | null;
-  /** The budget.json object for LightWallet. */
-  budgets?: Array<Budget> | null;
 
   /** The number of milliseconds to wait after FCP until the page should be considered loaded. */
   pauseAfterFcpMs?: number;

package/core/audits/performance-budget.d.ts

@@ -1,39 +0,0 @@
-export default ResourceBudget;
-export type ResourceEntry = import('../computed/resource-summary.js').ResourceEntry;
-export type BudgetItem = {
-    resourceType: LH.Budget.ResourceType;
-    label: LH.IcuMessage;
-    requestCount: number;
-    transferSize: number;
-    sizeOverBudget: number | undefined;
-    countOverBudget: LH.IcuMessage | undefined;
-};
-/** @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 */
-declare class ResourceBudget extends Audit {
-    /**
-     * @param {LH.Budget.ResourceType} resourceType
-     * @return {string}
-     */
-    static getRowLabel(resourceType: LH.Budget.ResourceType): string;
-    /**
-     * @param {LH.Util.Immutable<LH.Budget>} budget
-     * @param {Record<LH.Budget.ResourceType, ResourceEntry>} summary
-     * @return {Array<BudgetItem>}
-     */
-    static tableItems(budget: LH.Util.Immutable<LH.Budget>, summary: Record<LH.Budget.ResourceType, ResourceEntry>): Array<BudgetItem>;
-    /**
-     * @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 {
-    const title: string;
-    const description: string;
-    const requestCountOverBudget: string;
-}
-import { Budget } from '../config/budget.js';
-import { Audit } from './audit.js';
-//# sourceMappingURL=performance-budget.d.ts.map

package/core/audits/performance-budget.js

@@ -1,154 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import {Audit} from './audit.js';
-import {ResourceSummary} from '../computed/resource-summary.js';
-import {MainResource} from '../computed/main-resource.js';
-import {Budget} from '../config/budget.js';
-import * as i18n from '../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. The last sentence starting with 'Learn' 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 about performance budgets](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.createIcuMessageFn(import.meta.url, 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 {LH.Util.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', valueType: 'text', label: str_(i18n.UIStrings.columnResourceType)},
-      {key: 'requestCount', valueType: 'numeric', label: str_(i18n.UIStrings.columnRequests)},
-      {key: 'transferSize', valueType: 'bytes', label: str_(i18n.UIStrings.columnTransferSize)},
-      {key: 'countOverBudget', valueType: 'text', label: ''},
-      {key: 'sizeOverBudget', valueType: 'bytes', label: str_(i18n.UIStrings.columnOverBudget)},
-    ];
-
-    return {
-      details: Audit.makeTableDetails(headers,
-        this.tableItems(budget, summary), {sortedBy: ['sizeOverBudget']}),
-      score: 1,
-    };
-  }
-}
-
-export default ResourceBudget;
-export {UIStrings};

package/core/audits/timing-budget.d.ts

@@ -1,43 +0,0 @@
-export default TimingBudget;
-export type BudgetItem = {
-    metric: LH.Budget.TimingMetric;
-    label: LH.IcuMessage;
-    measurement?: LH.Audit.Details.NumericValue | number;
-    overBudget?: LH.Audit.Details.NumericValue | number;
-};
-/** @typedef {{metric: LH.Budget.TimingMetric, label: LH.IcuMessage, measurement?: LH.Audit.Details.NumericValue|number, overBudget?: LH.Audit.Details.NumericValue|number}} BudgetItem */
-declare class TimingBudget extends Audit {
-    /**
-     * @param {LH.Budget.TimingMetric} timingMetric
-     * @return {LH.IcuMessage}
-     */
-    static getRowLabel(timingMetric: LH.Budget.TimingMetric): LH.IcuMessage;
-    /**
-     * @param {LH.Budget.TimingMetric} timingMetric
-     * @param {LH.Artifacts.TimingSummary} summary
-     * @return {number|undefined}
-     */
-    static getMeasurement(timingMetric: LH.Budget.TimingMetric, summary: LH.Artifacts.TimingSummary): number | undefined;
-    /**
-     * @param {LH.Util.Immutable<LH.Budget>} budget
-     * @param {LH.Artifacts.TimingSummary} summary
-     * @return {Array<BudgetItem>}
-     */
-    static tableItems(budget: LH.Util.Immutable<LH.Budget>, summary: LH.Artifacts.TimingSummary): Array<BudgetItem>;
-    /**
-     * @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 {
-    const title: string;
-    const description: string;
-    const columnTimingMetric: string;
-    const columnMeasurement: string;
-}
-import { Budget } from '../config/budget.js';
-import { Audit } from './audit.js';
-import { TimingSummary } from '../computed/metrics/timing-summary.js';
-//# sourceMappingURL=timing-budget.d.ts.map

package/core/audits/timing-budget.js

@@ -1,175 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import {Audit} from './audit.js';
-import {TimingSummary} from '../computed/metrics/timing-summary.js';
-import {MainResource} from '../computed/main-resource.js';
-import {Budget} from '../config/budget.js';
-import * as i18n from '../lib/i18n/i18n.js';
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that compares how quickly the page loads against targets set by the user. Timing budgets are a type of performance budget. */
-  title: 'Timing budget',
-  /** Description of a Lighthouse audit where a user sets budgets for how quickly the page loads. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
-  description: 'Set a timing budget to help you keep an eye on the performance of your site. Performant sites load fast and respond to user input events quickly. [Learn more about performance budgets](https://developers.google.com/web/tools/lighthouse/audits/budgets).',
-  /** Label for a column in a data table; entries will be the names of different timing metrics, e.g. "Time to Interactive", "First Contentful Paint", etc. */
-  columnTimingMetric: 'Metric',
-  /** Label for a column in a data table; entries will be the measured value of a particular timing metric. Most entries will have a unit of milliseconds, but units could be other things as well. */
-  columnMeasurement: 'Measurement',
-};
-
-const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
-
-/** @typedef {{metric: LH.Budget.TimingMetric, label: LH.IcuMessage, measurement?: LH.Audit.Details.NumericValue|number, overBudget?: LH.Audit.Details.NumericValue|number}} BudgetItem */
-
-class TimingBudget extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'timing-budget',
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-      scoreDisplayMode: Audit.SCORING_MODES.INFORMATIVE,
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['devtoolsLogs', 'traces', 'URL', 'GatherContext'],
-    };
-  }
-
-  /**
-   * @param {LH.Budget.TimingMetric} timingMetric
-   * @return {LH.IcuMessage}
-   */
-  static getRowLabel(timingMetric) {
-    /** @type {Record<LH.Budget.TimingMetric, string>} */
-    const strMappings = {
-      'first-contentful-paint': i18n.UIStrings.firstContentfulPaintMetric,
-      'interactive': i18n.UIStrings.interactiveMetric,
-      'first-meaningful-paint': i18n.UIStrings.firstMeaningfulPaintMetric,
-      'max-potential-fid': i18n.UIStrings.maxPotentialFIDMetric,
-      'total-blocking-time': i18n.UIStrings.totalBlockingTimeMetric,
-      'speed-index': i18n.UIStrings.speedIndexMetric,
-      'largest-contentful-paint': i18n.UIStrings.largestContentfulPaintMetric,
-      'cumulative-layout-shift': i18n.UIStrings.cumulativeLayoutShiftMetric,
-    };
-    return str_(strMappings[timingMetric]);
-  }
-
-  /**
-   * @param {LH.Budget.TimingMetric} timingMetric
-   * @param {LH.Artifacts.TimingSummary} summary
-   * @return {number|undefined}
-   */
-  static getMeasurement(timingMetric, summary) {
-    /** @type {Record<LH.Budget.TimingMetric, number|undefined>} */
-    const measurements = {
-      'first-contentful-paint': summary.firstContentfulPaint,
-      'interactive': summary.interactive,
-      'first-meaningful-paint': summary.firstMeaningfulPaint,
-      'max-potential-fid': summary.maxPotentialFID,
-      'total-blocking-time': summary.totalBlockingTime,
-      'speed-index': summary.speedIndex,
-      'largest-contentful-paint': summary.largestContentfulPaint,
-      'cumulative-layout-shift': summary.cumulativeLayoutShift,
-    };
-    return measurements[timingMetric];
-  }
-
-  /**
-   * @param {LH.Util.Immutable<LH.Budget>} budget
-   * @param {LH.Artifacts.TimingSummary} summary
-   * @return {Array<BudgetItem>}
-   */
-  static tableItems(budget, summary) {
-    /** @type {Array<BudgetItem>} */
-    let items = [];
-    if (!budget.timings) {
-      return items;
-    }
-
-    items = budget.timings.map((timingBudget) => {
-      const metricName = timingBudget.metric;
-      const label = this.getRowLabel(metricName);
-      const measurement = this.getMeasurement(metricName, summary);
-      const overBudget = measurement && (measurement > timingBudget.budget)
-        ? (measurement - timingBudget.budget) : undefined;
-      return {
-        metric: metricName,
-        label,
-        measurement,
-        overBudget,
-      };
-    }).sort((a, b) => {
-      return (b.overBudget || 0) - (a.overBudget || 0);
-    });
-
-    // CLS requires a different granularity and should be a numeric type.
-    // Defining type here overrides the column setting so that it doesn't receive ms units.
-    const clsItem = items.find(item => item.metric === 'cumulative-layout-shift');
-    if (clsItem) {
-      if (typeof clsItem.measurement === 'number') {
-        clsItem.measurement = {
-          type: 'numeric',
-          value: Number(clsItem.measurement),
-          granularity: 0.01,
-        };
-      }
-      if (typeof clsItem.overBudget === 'number') {
-        clsItem.overBudget = {
-          type: 'numeric',
-          value: Number(clsItem.overBudget),
-          granularity: 0.01,
-        };
-      }
-    }
-
-    return items;
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const gatherContext = artifacts.GatherContext;
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    const trace = artifacts.traces[Audit.DEFAULT_PASS];
-    const URL = artifacts.URL;
-    const mainResource = await MainResource.request({URL, devtoolsLog}, context);
-    const data = {trace, devtoolsLog, gatherContext, settings: context.settings, URL};
-    const summary = (await TimingSummary.request(data, context)).metrics;
-    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', valueType: 'text', label: str_(UIStrings.columnTimingMetric)},
-      /**
-       * Note: SpeedIndex, unlike other timing metrics, is not measured in milliseconds.
-       * The renderer applies the correct units to the 'measurement' and 'overBudget' columns for SpeedIndex.
-       */
-      {key: 'measurement', valueType: 'ms', label: str_(UIStrings.columnMeasurement)},
-      {key: 'overBudget', valueType: 'ms', label: str_(i18n.UIStrings.columnOverBudget)},
-    ];
-
-    return {
-      details: Audit.makeTableDetails(headers, this.tableItems(budget, summary),
-      {sortedBy: ['overBudget']}),
-      score: 1,
-    };
-  }
-}
-
-export default TimingBudget;
-export {UIStrings};

package/core/config/budget.d.ts

@@ -1,74 +0,0 @@
-export class Budget {
-    /**
-     * Asserts that obj has no own properties, throwing a nice error message if it does.
-     * `objectName` is included for nicer logging.
-     * @param {Record<string, unknown>} obj
-     * @param {string} objectName
-     */
-    static assertNoExcessProperties(obj: Record<string, unknown>, objectName: string): void;
-    /**
-     * Asserts that `strings` has no duplicate strings in it, throwing an error if
-     * it does. `arrayName` is included for nicer logging.
-     * @param {Array<string>} strings
-     * @param {string} arrayName
-     */
-    static assertNoDuplicateStrings(strings: Array<string>, arrayName: string): void;
-    /**
-     * @param {Record<string, unknown>} resourceBudget
-     * @return {LH.Budget.ResourceBudget}
-     */
-    static validateResourceBudget(resourceBudget: Record<string, unknown>): LH.Budget.ResourceBudget;
-    /**
-     * @param {unknown} path
-     * @param {string} error
-     */
-    static throwInvalidPathError(path: unknown, error: string): void;
-    /**
-     * Validates that path is either: a) undefined or ) properly formed.
-     * Verifies the quantity and location of the two robot.txt regex characters: $, *
-     * @param {unknown} path
-     * @return {undefined|string}
-     */
-    static validatePath(path: unknown): undefined | string;
-    /**
-     * Returns the budget that applies to a given URL.
-     * If multiple budgets match based on thier 'path' property,
-     * then the last-listed of those budgets is returned.
-     * @param {LH.Util.Immutable<Array<LH.Budget>>|null} budgets
-     * @param {string|undefined} url
-     * @return {LH.Util.Immutable<LH.Budget> | undefined} budget
-     */
-    static getMatchingBudget(budgets: LH.Util.Immutable<Array<LH.Budget>> | null, url: string | undefined): LH.Util.Immutable<LH.Budget> | undefined;
-    /**
-     * Determines whether a URL matches against a robots.txt-style "path".
-     * Pattern should use the robots.txt format. E.g. "/*-article.html" or "/". Reference:
-     * https://developers.google.com/search/reference/robots_txt#url-matching-based-on-path-values
-     * @param {string} url
-     * @param {string=} pattern
-     * @return {boolean}
-     */
-    static urlMatchesPattern(url: string, pattern?: string | undefined): boolean;
-    /**
-     * @param {Record<string, unknown>} timingBudget
-     * @return {LH.Budget.TimingBudget}
-     */
-    static validateTimingBudget(timingBudget: Record<string, unknown>): LH.Budget.TimingBudget;
-    /**
-     * @param {string} hostname
-     * @return {string}
-     */
-    static validateHostname(hostname: string): string;
-    /**
-     * @param {unknown} hostnames
-     * @return {undefined|Array<string>}
-     */
-    static validateHostnames(hostnames: unknown): undefined | Array<string>;
-    /**
-     * More info on the Budget format:
-     * https://github.com/GoogleChrome/lighthouse/issues/6053#issuecomment-428385930
-     * @param {unknown} budgetJson
-     * @return {Array<LH.Budget>}
-     */
-    static initializeBudget(budgetJson: unknown): Array<LH.Budget>;
-}
-//# sourceMappingURL=budget.d.ts.map