lighthouse 11.7.1 → 12.0.0

package/core/audits/themed-omnibox.d.ts

@@ -1,42 +0,0 @@
-export default ThemedOmnibox;
-/**
- * @fileoverview
- * Audits if a page is configured for a themed address bar
- *
- * Requirements:
- *   * manifest is not empty
- *   * manifest has a theme_color
- *   * HTML has a theme-color meta
- *
- * Color validity is explicitly not checked.
- */
-declare class ThemedOmnibox extends MultiCheckAudit {
-    /**
-     * @param {LH.Artifacts.MetaElement|undefined} themeColorMeta
-     * @param {Array<string>} failures
-     */
-    static assessMetaThemecolor(themeColorMeta: LH.Artifacts.MetaElement | undefined, failures: Array<string>): void;
-    /**
-     * @param {LH.Artifacts.ManifestValues} manifestValues
-     * @param {Array<string>} failures
-     */
-    static assessManifest(manifestValues: LH.Artifacts.ManifestValues, failures: Array<string>): void;
-    /**
-     * @param {LH.Artifacts} artifacts
-     * @param {LH.Audit.Context} context
-     * @return {Promise<{failures: Array<string>, manifestValues: LH.Artifacts.ManifestValues, themeColor: ?string}>}
-     */
-    static audit_(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<{
-        failures: Array<string>;
-        manifestValues: LH.Artifacts.ManifestValues;
-        themeColor: string | null;
-    }>;
-}
-export namespace UIStrings {
-    const title: string;
-    const failureTitle: string;
-    const description: string;
-}
-import MultiCheckAudit from './multi-check-audit.js';
-import { ManifestValues } from '../computed/manifest-values.js';
-//# sourceMappingURL=themed-omnibox.d.ts.map

package/core/audits/themed-omnibox.js

@@ -1,102 +0,0 @@
-/**
- * @license
- * Copyright 2017 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import MultiCheckAudit from './multi-check-audit.js';
-import {ManifestValues} from '../computed/manifest-values.js';
-import * as i18n from '../lib/i18n/i18n.js';
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that provides detail on the theme color the web page has set for the browser's address bar. This descriptive title is shown to users when an address-bar theme color has been set. */
-  title: 'Sets a theme color for the address bar.',
-  /** Title of a Lighthouse audit that provides detail on the theme color the web page has set for the browser's address bar. This descriptive title is shown to users when an address-bar theme color has not been set. */
-  failureTitle: 'Does not set a theme color for the address bar.',
-  /** Description of a Lighthouse audit that tells the user why they should set a theme color for the browser's address bar. 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: 'The browser address bar can be themed to match your site. ' +
-    '[Learn more about theming the address bar](https://developer.chrome.com/docs/lighthouse/pwa/themed-omnibox/).',
-};
-
-const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
-
-/**
- * @fileoverview
- * Audits if a page is configured for a themed address bar
- *
- * Requirements:
- *   * manifest is not empty
- *   * manifest has a theme_color
- *   * HTML has a theme-color meta
- *
- * Color validity is explicitly not checked.
- */
-
-class ThemedOmnibox extends MultiCheckAudit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'themed-omnibox',
-      title: str_(UIStrings.title),
-      failureTitle: str_(UIStrings.failureTitle),
-      description: str_(UIStrings.description),
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['WebAppManifest', 'InstallabilityErrors', 'MetaElements'],
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts.MetaElement|undefined} themeColorMeta
-   * @param {Array<string>} failures
-   */
-  static assessMetaThemecolor(themeColorMeta, failures) {
-    if (!themeColorMeta) {
-      // TODO(#7238): i18n
-      failures.push('No `<meta name="theme-color">` tag found');
-    } else if (!themeColorMeta.content) {
-      failures.push('The theme-color meta tag did not contain a content value');
-    }
-  }
-
-  /**
-   * @param {LH.Artifacts.ManifestValues} manifestValues
-   * @param {Array<string>} failures
-   */
-  static assessManifest(manifestValues, failures) {
-    if (manifestValues.isParseFailure && manifestValues.parseFailureReason) {
-      failures.push(manifestValues.parseFailureReason);
-      return;
-    }
-
-    const themeColorCheck = manifestValues.allChecks.find(i => i.id === 'hasThemeColor');
-    if (themeColorCheck && !themeColorCheck.passing) {
-      failures.push(themeColorCheck.failureText);
-    }
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<{failures: Array<string>, manifestValues: LH.Artifacts.ManifestValues, themeColor: ?string}>}
-   */
-  static async audit_(artifacts, context) {
-    /** @type {Array<string>} */
-    const failures = [];
-
-    const themeColorMeta = artifacts.MetaElements.find(meta => meta.name === 'theme-color');
-    const manifestValues = await ManifestValues.request(artifacts, context);
-    ThemedOmnibox.assessManifest(manifestValues, failures);
-    ThemedOmnibox.assessMetaThemecolor(themeColorMeta, failures);
-
-    return {
-      failures,
-      manifestValues,
-      themeColor: themeColorMeta?.content || null,
-    };
-  }
-}
-
-export default ThemedOmnibox;
-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/computed/manifest-values.d.ts

@@ -1,24 +0,0 @@
-export { ManifestValuesComputed as ManifestValues };
-declare const ManifestValuesComputed: typeof ManifestValues & {
-    request: (dependencies: Pick<import("../index.js").Artifacts, "InstallabilityErrors" | "WebAppManifest">, context: import("../../types/utility-types.js").default.ImmutableObject<{
-        computedCache: Map<string, import("../lib/arbitrary-equality-map.js").ArbitraryEqualityMap>;
-    }>) => Promise<import("../index.js").Artifacts.ManifestValues>;
-};
-declare class ManifestValues {
-    /** @typedef {(val: NonNullable<LH.Artifacts.Manifest['value']>, errors: LH.Artifacts.InstallabilityErrors['errors']) => boolean} Validator */
-    /**
-     * @return {Array<{id: LH.Artifacts.ManifestValueCheckID, failureText: string, validate: Validator}>}
-     */
-    static get manifestChecks(): {
-        id: LH.Artifacts.ManifestValueCheckID;
-        failureText: string;
-        validate: (val: NonNullable<LH.Artifacts.Manifest['value']>, errors: LH.Artifacts.InstallabilityErrors['errors']) => boolean;
-    }[];
-    /**
-     * Returns results of all manifest checks
-     * @param {Pick<LH.Artifacts, 'WebAppManifest'|'InstallabilityErrors'>} Manifest
-     * @return {Promise<LH.Artifacts.ManifestValues>}
-     */
-    static compute_({ WebAppManifest, InstallabilityErrors }: Pick<LH.Artifacts, 'WebAppManifest' | 'InstallabilityErrors'>): Promise<LH.Artifacts.ManifestValues>;
-}
-//# sourceMappingURL=manifest-values.d.ts.map

package/core/computed/manifest-values.js

@@ -1,136 +0,0 @@
-/**
- * @license
- * Copyright 2016 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import {makeComputedArtifact} from './computed-artifact.js';
-import * as icons from '../lib/icons.js';
-
-const PWA_DISPLAY_VALUES = ['minimal-ui', 'fullscreen', 'standalone'];
-
-// Historically, Chrome recommended 12 chars as the maximum short_name length to prevent truncation.
-// For more discussion, see https://github.com/GoogleChrome/lighthouse/issues/69 and https://developer.chrome.com/apps/manifest/name#short_name
-const SUGGESTED_SHORTNAME_LENGTH = 12;
-
-class ManifestValues {
-  /** @typedef {(val: NonNullable<LH.Artifacts.Manifest['value']>, errors: LH.Artifacts.InstallabilityErrors['errors']) => boolean} Validator */
-
-  /**
-   * @return {Array<{id: LH.Artifacts.ManifestValueCheckID, failureText: string, validate: Validator}>}
-   */
-  static get manifestChecks() {
-    return [
-      {
-        id: 'hasStartUrl',
-        failureText: 'Manifest does not contain a `start_url`',
-        validate: manifestValue => !!manifestValue.start_url.value,
-      },
-      {
-        id: 'hasIconsAtLeast144px',
-        failureText: 'Manifest does not have a PNG icon of at least 144px',
-        validate: manifestValue => icons.doExist(manifestValue) &&
-            icons.pngSizedAtLeast(144, manifestValue).length > 0,
-      },
-      {
-        id: 'hasIconsAtLeast512px',
-        failureText: 'Manifest does not have a PNG icon of at least 512px',
-        validate: manifestValue => icons.doExist(manifestValue) &&
-            icons.pngSizedAtLeast(512, manifestValue).length > 0,
-      },
-      {
-        id: 'fetchesIcon',
-        failureText: 'Manifest icon failed to be fetched',
-        validate: (manifestValue, errors) => {
-          const failedToFetchIconErrorIds = [
-            'cannot-download-icon',
-            'no-icon-available',
-          ];
-          return icons.doExist(manifestValue) &&
-            !errors.some(error => failedToFetchIconErrorIds.includes(error.errorId));
-        },
-      },
-      {
-        id: 'hasPWADisplayValue',
-        failureText: 'Manifest\'s `display` value is not one of: ' + PWA_DISPLAY_VALUES.join(' | '),
-        validate: manifestValue => PWA_DISPLAY_VALUES.includes(manifestValue.display.value),
-      },
-      {
-        id: 'hasBackgroundColor',
-        failureText: 'Manifest does not have `background_color`',
-        validate: manifestValue => !!manifestValue.background_color.value,
-      },
-      {
-        id: 'hasThemeColor',
-        failureText: 'Manifest does not have `theme_color`',
-        validate: manifestValue => !!manifestValue.theme_color.value,
-      },
-      {
-        id: 'hasShortName',
-        failureText: 'Manifest does not have `short_name`',
-        validate: manifestValue => !!manifestValue.short_name.value,
-      },
-      {
-        id: 'shortNameLength',
-        failureText: `Manifest's \`short_name\` is too long (>${SUGGESTED_SHORTNAME_LENGTH} ` +
-          `characters) to be displayed on a homescreen without truncation`,
-        // Pass if there's no short_name. Don't want to report a non-existent string is too long
-        validate: manifestValue => !!manifestValue.short_name.value &&
-            manifestValue.short_name.value.length <= SUGGESTED_SHORTNAME_LENGTH,
-      },
-      {
-        id: 'hasName',
-        failureText: 'Manifest does not have `name`',
-        validate: manifestValue => !!manifestValue.name.value,
-      },
-      {
-        id: 'hasMaskableIcon',
-        failureText: 'Manifest does not have at least one icon that is maskable',
-        validate: ManifestValue => icons.doExist(ManifestValue) &&
-            icons.containsMaskableIcon(ManifestValue),
-      },
-    ];
-  }
-
-  /**
-   * Returns results of all manifest checks
-   * @param {Pick<LH.Artifacts, 'WebAppManifest'|'InstallabilityErrors'>} Manifest
-   * @return {Promise<LH.Artifacts.ManifestValues>}
-   */
-  static async compute_({WebAppManifest, InstallabilityErrors}) {
-    // if the manifest isn't there or is invalid json, we report that and bail
-    if (WebAppManifest === null) {
-      return {
-        isParseFailure: true,
-        parseFailureReason: 'No manifest was fetched',
-        allChecks: [],
-      };
-    }
-    const manifestValue = WebAppManifest.value;
-    if (manifestValue === undefined) {
-      return {
-        isParseFailure: true,
-        parseFailureReason: 'Manifest failed to parse as valid JSON',
-        allChecks: [],
-      };
-    }
-
-    // manifest is valid, so do the rest of the checks
-    const remainingChecks = ManifestValues.manifestChecks.map(item => {
-      return {
-        id: item.id,
-        failureText: item.failureText,
-        passing: item.validate(manifestValue, InstallabilityErrors.errors),
-      };
-    });
-
-    return {
-      isParseFailure: false,
-      allChecks: remainingChecks,
-    };
-  }
-}
-
-const ManifestValuesComputed =
-  makeComputedArtifact(ManifestValues, ['InstallabilityErrors', 'WebAppManifest']);
-export {ManifestValuesComputed as ManifestValues};

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