lighthouse 9.6.8 → 10.0.0

package/lighthouse-core/lib/emulation.js

@@ -1,164 +0,0 @@
-/**
- * @license Copyright 2016 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 {version: lighthouseVersion} = require('../../package.json');
-
-const NO_THROTTLING_METRICS = {
-  latency: 0,
-  downloadThroughput: 0,
-  uploadThroughput: 0,
-  offline: false,
-};
-
-const NO_CPU_THROTTLE_METRICS = {
-  rate: 1,
-};
-
-/**
- * @param {string} userAgent
- * @param {LH.Config.Settings['formFactor']} formFactor
- * @return {LH.Crdp.Emulation.SetUserAgentOverrideRequest['userAgentMetadata']}
- */
-function parseUseragentIntoMetadata(userAgent, formFactor) {
-  const match = userAgent.match(/Chrome\/([\d.]+)/); // eg 'Chrome/(71.0.3577.0)'
-  const fullVersion = match?.[1] || '99.0.1234.0';
-  const [version] = fullVersion.split('.', 1);
-  const brands = [
-    {brand: 'Chromium', version},
-    {brand: 'Google Chrome', version},
-    {brand: 'Lighthouse', version: lighthouseVersion},
-  ];
-
-  const motoG4Details = {
-    platform: 'Android',
-    platformVersion: '6.0',
-    architecture: '',
-    model: 'Moto G4',
-  };
-  const macDesktopDetails = {
-    platform: 'macOS',
-    platformVersion: '10.15.7',
-    architecture: 'x86',
-    model: '',
-  };
-  const mobile = formFactor === 'mobile';
-
-  return {
-    brands,
-    fullVersion,
-    // Since config users can supply a custom useragent, they likely are emulating something
-    // other than Moto G4 and MacOS Desktop.
-    // TODO: Determine how to thoughtfully expose this metadata/client-hints configurability.
-    ...(mobile ? motoG4Details : macDesktopDetails),
-    mobile,
-  };
-}
-
-/**
- * @param {LH.Gatherer.FRProtocolSession} session
- * @param {LH.Config.Settings} settings
- * @return {Promise<void>}
- */
-async function emulate(session, settings) {
-  if (settings.emulatedUserAgent !== false) {
-    const userAgent = /** @type {string} */ (settings.emulatedUserAgent);
-    await session.sendCommand('Network.setUserAgentOverride', {
-      userAgent,
-      userAgentMetadata: parseUseragentIntoMetadata(userAgent, settings.formFactor),
-    });
-  }
-  // See devtools-entry for one usecase for disabling screenEmulation
-  if (settings.screenEmulation.disabled !== true) {
-    const {width, height, deviceScaleFactor, mobile} = settings.screenEmulation;
-    const params = {width, height, deviceScaleFactor, mobile};
-    await session.sendCommand('Emulation.setDeviceMetricsOverride', params);
-    await session.sendCommand('Emulation.setTouchEmulationEnabled', {
-      enabled: params.mobile,
-    });
-  }
-}
-
-/**
- * Sets the throttling options specified in config settings, clearing existing network throttling if
- * throttlingMethod is not `devtools` (but not CPU throttling, suspected requirement of WPT-compat).
- *
- * @param {LH.Gatherer.FRProtocolSession} session
- * @param {LH.Config.Settings} settings
- * @return {Promise<void>}
- */
-async function throttle(session, settings) {
-  if (settings.throttlingMethod !== 'devtools') return clearNetworkThrottling(session);
-
-  await Promise.all([
-    enableNetworkThrottling(session, settings.throttling),
-    enableCPUThrottling(session, settings.throttling),
-  ]);
-}
-
-/**
- * @param {LH.Gatherer.FRProtocolSession} session
- * @return {Promise<void>}
- */
-async function clearThrottling(session) {
-  await Promise.all([clearNetworkThrottling(session), clearCPUThrottling(session)]);
-}
-
-/**
- * @param {LH.Gatherer.FRProtocolSession} session
- * @param {Required<LH.ThrottlingSettings>} throttlingSettings
- * @return {Promise<void>}
- */
-function enableNetworkThrottling(session, throttlingSettings) {
-  /** @type {LH.Crdp.Network.EmulateNetworkConditionsRequest} */
-  const conditions = {
-    offline: false,
-    latency: throttlingSettings.requestLatencyMs || 0,
-    downloadThroughput: throttlingSettings.downloadThroughputKbps || 0,
-    uploadThroughput: throttlingSettings.uploadThroughputKbps || 0,
-  };
-
-  // DevTools expects throughput in bytes per second rather than kbps
-  conditions.downloadThroughput = Math.floor(conditions.downloadThroughput * 1024 / 8);
-  conditions.uploadThroughput = Math.floor(conditions.uploadThroughput * 1024 / 8);
-  return session.sendCommand('Network.emulateNetworkConditions', conditions);
-}
-
-/**
- * @param {LH.Gatherer.FRProtocolSession} session
- * @return {Promise<void>}
- */
-function clearNetworkThrottling(session) {
-  return session.sendCommand('Network.emulateNetworkConditions', NO_THROTTLING_METRICS);
-}
-
-/**
- * @param {LH.Gatherer.FRProtocolSession} session
- * @param {Required<LH.ThrottlingSettings>} throttlingSettings
- * @return {Promise<void>}
- */
-function enableCPUThrottling(session, throttlingSettings) {
-  const rate = throttlingSettings.cpuSlowdownMultiplier;
-  return session.sendCommand('Emulation.setCPUThrottlingRate', {rate});
-}
-
-/**
- * @param {LH.Gatherer.FRProtocolSession} session
- * @return {Promise<void>}
- */
-function clearCPUThrottling(session) {
-  return session.sendCommand('Emulation.setCPUThrottlingRate', NO_CPU_THROTTLE_METRICS);
-}
-
-module.exports = {
-  emulate,
-  throttle,
-  clearThrottling,
-  enableNetworkThrottling,
-  clearNetworkThrottling,
-  enableCPUThrottling,
-  clearCPUThrottling,
-};

package/lighthouse-core/lib/i18n/README.md

@@ -1,273 +0,0 @@
-# Terminology
-
-* **CTC format**: The [Chrome extension & Chrome app i18n format](https://developer.chrome.com/extensions/i18n-messages) with some minor changes. JSON with their specified model for declaring placeholders, examples, etc. Used as an interchange data format.
-* **LHL syntax** (Lighthouse Localizable syntax): The ICU-friendly string syntax that is used to author `UIStrings` and is seen in the locale files in `shared/localization/locales/*.json`. Lighthouse has a custom syntax these strings combines many ICU message features along with some markdown.
-* **ICU**: ICU (International Components for Unicode) is a localization project and standard defined by the Unicode consortium. In general, we refer to "ICU" as the [ICU message formatting](http://userguide.icu-project.org/formatparse/messages) syntax.
-
-# The Lighthouse i18n pipeline
-
-The translation pipeline has 3 distinct stages, the Collection done at build time, the Translation done in the Google TC pipeline, and the Replacement done at runtime.
-
-The collection and translation pipeline:
-```
- Source files:                                         Locale files:
-+---------------------------+                         +----------------------------------------------
-|                           ++                        | shared/localization/locales/en-US.json |
-| const UIStrings = { ... };|-+                 +---> | shared/localization/locales/en-XL.json |
-|                           |-|                 |     +----------------------------------------------+
-+-----------------------------|                 |     |                                             ||
- +----------------------------|                 |     | shared/localization/locales/*.json     |-<+
-  +---------------------------+                 |     |                                             || |
-                           |                    |     +----------------------------------------------| |
-  $ yarn                   |                    |      +---------------------------------------------+ |
-      i18n:collect-strings +--------------------+                                                      |
-                           |                                                                           |
-                           v                          ▐                       ▐    +---------------+   |
-              +------------+------+                   ▐   Google TC Pipeline  ▐ +->|  *.ctc.json   |---+
-              |  en-US.ctc.json   |  +--------------> ▐      (~2 weeks)       ▐    +---------------+
-              +-------------------+  $ g3/import….sh  ▐                       ▐ $ g3/export….sh
-```
-
-#### String Collection workflow (build time)
-
-To a typical developer, the pipeline looks like this:
-
-* LH contributor makes any changes to strings.
-
-```shell
-# collect UIStrings and bake the en-US & en-XL locales
-$ yarn i18n:collect-strings
-
-# Test to see that the new translations are valid and apply to all strings
-$ yarn build-sample-reports && open dist/xl-accented/index.html
-```
-
-Note: Why do `en-US` and `en-XL` get baked early?  We write all our strings in `en-US` by default, so they do not need to be translated, so it can be immediately baked without going to the translators.  Similarly, `en-XL` is a debugging language, it is an automated version of `en-US` that simply adds markers to `en` strings in order to make it obvious that something has or hasn't been translated.  So neither of these files need to go to translators to be used, and both can be used at develop-time to help developer i18n workflow.
-
-#### String Translation in Google Translation Console
-
-* Googler is ready to kick off the TC pipeline again.
-
-```shell
-# collect UIStrings (to make sure everything is up to date)
-$ yarn i18n:collect-strings
-
-# Extract the CTC format files to translation console
-$ sh import-source-from-github.sh
-
-# Submit CL. Wait ~2 weeks for translations
-
-# Import the translated CTC format files to locales/ and bake them
-$ sh export-tc-dump-to-github.sh
-```
-
-#### String Replacement (runtime)
-
-See [Appendix A: How runtime string replacement works](#appendix)
-
-
-
-# Writing UIStrings with LHL
-
-We want to keep strings close to the code in which they are used so that developers can easily understand their context. We use `i18n.js` to extract the `UIStrings` strings from individual js files.
-
-LHL strings in each module are defined in a `UIStrings` object with the strings as its properties. JSDoc is used to provide additional information about each string.
-
-The LHL syntax is based primarily around the standardized [ICU message formatting](http://userguide.icu-project.org/formatparse/messages) syntax.
-
-
-### Basic example
-
-A simple string.
-
-```javascript
-const UIStrings = {
-  /** Imperative title of a Lighthouse audit that ... */
-  title: 'Minify CSS',
-};
-```
-
-For proper translation, **all** strings must be accompanied by a description, written as a preceeding comment.
-
-
-### Replacements and primitive formatting
-
-Replacements (aka substitutions) include string replacements like `{some_name}` and number formatting like `{timeInMs, number, milliseconds}`.
-
-#### Direct ICU replacement
-
-`{some_name}` is called _Direct ICU_ since the replacement is a direct substitution of ICU with a variable and uses no custom formatting. This is simply a direct replacement of text into a string. Often used for proper nouns, code, or other text that is dynamic and added at runtime.
-
-ICU replacements must use a JSDoc-like syntax to specify an example for direct ICU replacements:
-
-*   To specify the description, use `@description …`:
-    * `@description Label string used to…`
-*   To specify an example for an ICU replacement, use `@example {…} …`:
-    * `@example {This is an example ICU replacement} variableName`
-
-```javascript
-const UIStrings = {
-    /**
-      * @description Error message explaining ...
-      * @example {NO_SPEEDLINE_FRAMES} errorCode
-      */
-    didntCollectScreenshots: `Chrome didn't .... ({errorCode})`,
-};
-```
-
-#### Complex ICU replacement
-
-`{timeInMs, number, milliseconds}` is called _Complex ICU_ since the replacement is for numbers and other complex replacements that use the custom formatters in Lighthouse. The supported complex ICU formats are: `milliseconds`, `seconds`, `bytes`, `percent`, and `extendedPercent`.
-
-These complex ICU formats are automatically given @example values during `yarn i18n:collect-strings`.  Therefore, a normal description string can be used:
-
-```javascript
-const UIStrings = {
-    /** Description of display value. */
-    displayValueText: 'Interactive at {timeInMs, number, seconds} s',
-};
-```
-
-### Ordinals (Numeric Selects), Plurals
-
-An ordinal ICU message is used when the message contains "plurals", wherein a sub-message would need to be selected from a list of messages depending on the value of `itemCount` (in this example).  They are a flavor of "Selects" that have a unique syntax.
-
-```javascript
-displayValue: `{itemCount, plural,
-  =1 {1 link found}
-  other {# links found}
-  }`,
-```
-
-Note: Why are direct ICU and complex ICU placeholdered out, but Ordinals are not?  Direct and complex ICU should not contain elements that need to be translated (Direct ICU replaces universal proper nouns, and Complex ICU replaces number formatting), while ordinals do need to be translated.  Ordinals and selects are therefore handled specially, and do not need to be placeholdered out.
-
-### Selects
-
-A select ICU message is used when the message should select a sub-message based on the value of a variable `pronoun` in this case. This is often used for gender based selections, but can be used for any enum.  Lighthouse does not use selects very often.
-
-```javascript
-displayValue: `{pronoun, select,
-  male {He programmed the link.}
-  female {She programmed the link.}
-  other {They programmed the link.}
-  }`,
-```
-
-
-### Markdown
-
-Some strings, like audit descriptions, can also contain a subset of markdown. See [`audit.d.ts`](https://github.com/GoogleChrome/lighthouse/blob/5e52dcca72b35943d14cc7c27613517c425250b9/types/audit.d.ts) for which properties support markdown rendering and will be rendered in the report.
-
-**Inline code blocks**
-
-To format some text as code it should be contained in `backticks`. Any text within the backticks will not be translated. This should be used whenever code is non-translatable. Such as HTML tags or snippets of code. Also note that there is no escape character for using backticks as part of the string, so ONLY use backticks to define code blocks.
-
-```javascript
-const UIStrings = {
-  title: 'Document has a `<title>` element',
-};
-```
-
-**Links**
-
-To convert a section of text into a link to another URL, enclose the text itself in [brackets] and then immediately include a link after it in (parentheses). Note that `[link text] (https://...)` is NOT VALID because of the space and will not be converted to a link.
-
-```javascript
-const UIStrings = {
-  description: 'The value of ... [Learn More](https://google.com/)',
-};
-```
-
-
-### Why do we call it LHL?
-
-LHL is a name that is distinct and identifies this as the LightHouse Locale format. Since both LHL and CTC use `.json` files it is ambiguous, so LHL is the given name for the string format that `UIStrings` objects and `locale/*.json` files that are consumed by the Lighthouse i18n engine.
-
-# CTC file format (CTC)
-
-### Why do we use CTC as our i18n messages interchange format?
-
-There are a few data formats used for holding messages for internationalization, including XMB and XLIFF.  We needed a JS-friendly format supported by Google's Translation Console (TC). This format is [somewhat well-specified](https://developer.chrome.com/extensions/i18n-messages) and defined in JSON rather than XML. ;)
-
-### Why do we call it CTC?
-
-CTC is a name that is distinct and identifies this as the Chrome translation format.  `messages.json` is ambiguous in our opinion and so throughout the docs we will refer to files that follow the `messages.json` format as being CTC files with a `.ctc.json` suffix.
-
-### Parts of a CTC message
-
-```json
-{
-  "name": {
-    "message": "Message text, with optional placeholders.",
-    "description": "Translator-aimed description of the message.",
-    "meaning": "Description given when a message is duplicated, in order to give context to the message. Lighthouse uses a copy of the description for this.",
-    "placeholders": {
-      "placeholder_name": {
-        "content": "A string to be placed within the message.",
-        "example": "Translator-aimed example of the placeholder string."
-      },
-    }
-  }
-}
-```
-
-# Appendix
-
-##  Appendix A: How runtime string replacement works
-
-1.  String called in `.js` file, converted to `LH.IcuMessage` object.
-
-1.  Message object is replaced with the localized string via
-    `format.replaceIcuMessages` and `format.getFormatted`.
-
-#### Example:
-
-1.  string in `lighthouse-core/lib/file_with_uistrings.js`
-
-    ```javascript
-    // Declare UIStrings
-    const UIStrings = {
-      /** Used to summarize the total byte size of the page and.... */
-      totalSize: 'Total size was {totalBytes, number, bytes} KiB',
-    };
-
-    // Init the strings in this file with the i18n system.
-    const str_ = i18n.createIcuMessageFn(__filename, UIStrings);
-
-    // Create an IcuMessage instance with a replacement value for our localizable string.
-    const icuMessage = str_(UIStrings.totalSize, {totalBytes: 10240});
-    ```
-
-2.  `icuMessage` contains information to localize a message into available locales, including a default fallback created from the original (non-localized) string.
-
-    ```javascript
-    // icuMessage
-    {
-      i18nId: 'lighthouse-core/lib/file_with_uistrings.js | totalSize',
-      values: {
-        totalBytes: 10240
-      },
-      formattedDefault: 'Total size was 10 KiB'
-    }
-    ```
-
-3.  Lookup in `format.replaceIcuMessages` and `format.getFormatted` will attempt to find the message in this order:
-
-    1.  `locales/{locale}.json` The best result. `icuMessage.i18nId` is found in the target locale and the resulting string should appear correct.
-
-    2.  `locales/en-US.json` _Okay_ result. `icuMessage.i18nId` was not found in the target locale, but it was in `en-US`, so the English string is used.
-
-    3.  The fallback message in `icuMessage.formattedDefault`. This string will be in English, but the lookup is subtly different than the `en-US` lookup. An `IcuMessage` whose `i18nId` is not in `en-US` may be part of an old set of artifacts (or an old LHR passed into `swap-locale`) that contains a string that has since been removed from Lighthouse. The `formattedDefault` is the only option in that case.
-
-    This is also the point at which ICU is replaced by values. So this...
-
-    ```javascript
-    totalSize = "Total size was {totalBytes, number, bytes} KiB"
-    values = {totalBytes: 10240}
-    ```
-
-    Becomes...
-
-    ```javascript
-    message = "Total size was 10 KiB"
-    ```

package/lighthouse-core/lib/i18n/i18n.js

@@ -1,221 +0,0 @@
-/**
- * @license Copyright 2018 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';
-
-/** @typedef {import('../../../shared/localization/locales').LhlMessages} LhlMessages */
-
-const path = require('path');
-const lookupClosestLocale = require('lookup-closest-locale');
-const {getAvailableLocales} = require('../../../shared/localization/format.js');
-const log = require('lighthouse-logger');
-const {LH_ROOT} = require('../../../root.js');
-const {
-  isIcuMessage,
-  formatMessage,
-  DEFAULT_LOCALE,
-} = require('../../../shared/localization/format.js');
-
-const UIStrings = {
-  /** Used to show the duration in milliseconds that something lasted. The `{timeInMs}` placeholder will be replaced with the time duration, shown in milliseconds (e.g. 63 ms) */
-  ms: '{timeInMs, number, milliseconds}\xa0ms',
-  /** Used to show the duration in seconds that something lasted. The {timeInMs} placeholder will be replaced with the time duration, shown in seconds (e.g. 5.2 s) */
-  seconds: '{timeInMs, number, seconds}\xa0s',
-  /** Label shown per-audit to show how many bytes smaller the page could be if the user implemented the suggestions. The `{wastedBytes}` placeholder will be replaced with the number of bytes, shown in kibibytes (e.g. 148 KiB) */
-  displayValueByteSavings: 'Potential savings of {wastedBytes, number, bytes}\xa0KiB',
-  /** Label shown per-audit to show how many milliseconds faster the page load could be if the user implemented the suggestions. The `{wastedMs}` placeholder will be replaced with the time duration, shown in milliseconds (e.g. 140 ms) */
-  displayValueMsSavings: 'Potential savings of {wastedMs, number, milliseconds}\xa0ms',
-  /** Label shown per-audit to show how many HTML elements did not pass the audit. The `{# elements found}` placeholder will be replaced with the number of failing HTML elements. */
-  displayValueElementsFound: `{nodeCount, plural, =1 {1 element found} other {# elements found}}`,
-  /** Label for a column in a data table; entries will be the URL of a web resource */
-  columnURL: 'URL',
-  /** Label for a column in a data table; entries will be the size or quantity of some resource, e.g. the width and height dimensions of an image or the number of images in a web page. */
-  columnSize: 'Size',
-  /** Label for a column in a data table; entries will be the file size of a web resource in kilobytes. */
-  columnResourceSize: 'Resource Size',
-  /** Label for a column in a data table; entries will be the download size of a web resource in kilobytes. */
-  columnTransferSize: 'Transfer Size',
-  /** Label for a column in a data table; entries will be the time to live value of the cache header on a web resource. */
-  columnCacheTTL: 'Cache TTL',
-  /** Label for a column in a data table; entries will be the number of kilobytes the user could reduce their page by if they implemented the suggestions. */
-  columnWastedBytes: 'Potential Savings',
-  /** Label for a column in a data table; entries will be the number of milliseconds the user could reduce page load by if they implemented the suggestions. */
-  columnWastedMs: 'Potential Savings',
-  /** Label for a table column that displays how much time each row spent blocking other work on the main thread, entries will be the number of milliseconds spent. */
-  columnBlockingTime: 'Main-Thread Blocking Time',
-  /** Label for a column in a data table; entries will be the number of milliseconds spent during a particular activity. */
-  columnTimeSpent: 'Time Spent',
-  /** Label for a column in a data table; entries will be the location of a specific line of code in a file, in the format "line: 102". */
-  columnLocation: 'Location',
-  /** Label for a column in a data table; entries will be types of resources loaded over the network, e.g. "Scripts", "Third-Party", "Stylesheet". */
-  columnResourceType: 'Resource Type',
-  /** Label for a column in a data table; entries will be the number of network requests done by a webpage. */
-  columnRequests: 'Requests',
-  /** Label for a column in a data table; entries will be the names of arbitrary objects, e.g. the name of a Javascript library, or the name of a user defined timing event. */
-  columnName: 'Name',
-  /** Label for a column in a data table; entries will be the locations of JavaScript or CSS code, e.g. the name of a Javascript package or module. */
-  columnSource: 'Source',
-  /** Label for a column in a data table; entries will be how much a predetermined budget has been exeeded by. Depending on the context, this number could represent an excess in quantity or size of network requests, or, an excess in the duration of time that it takes for the page to load.*/
-  columnOverBudget: 'Over Budget',
-  /** Label for a column in a data table; entries will be a representation of a DOM element. */
-  columnElement: 'Element',
-  /** Label for a column in a data table; entries will be the number of milliseconds since the page started loading. */
-  columnStartTime: 'Start Time',
-  /** Label for a column in a data table; entries will be the total number of milliseconds from the start time until the end time. */
-  columnDuration: 'Duration',
-  /** Label for a column in a data table; entries will be a representation of a DOM element that did not meet certain suggestions. */
-  columnFailingElem: 'Failing Elements',
-  /** Label for a column in a data table; entries will be a description of the table item. */
-  columnDescription: 'Description',
-  /** Label for a row in a data table; entries will be the total number and byte size of all resources loaded by a web page. */
-  totalResourceType: 'Total',
-  /** Label for a row in a data table; entries will be the total number and byte size of all 'Document' resources loaded by a web page. */
-  documentResourceType: 'Document',
-  /** Label for a row in a data table; entries will be the total number and byte size of all 'Script' resources loaded by a web page. 'Script' refers to JavaScript or other files that are executable by a browser. */
-  scriptResourceType: 'Script',
-  /** Label for a row in a data table; entries will be the total number and byte size of all 'Stylesheet' resources loaded by a web page. 'Stylesheet' refers to CSS stylesheets. */
-  stylesheetResourceType: 'Stylesheet',
-  /** Label for a row in a data table; entries will be the total number and byte size of all 'Image' resources loaded by a web page. */
-  imageResourceType: 'Image',
-  /** Label for a row in a data table; entries will be the total number and byte size of all 'Media' resources loaded by a web page. 'Media' refers to audio and video files. */
-  mediaResourceType: 'Media',
-  /** Label for a row in a data table; entries will be the total number and byte size of all 'Font' resources loaded by a web page. */
-  fontResourceType: 'Font',
-  /** Label for a row in a data table; entries will be the total number and byte size of all resources loaded by a web page that don't fit into the categories of Document, Script, Stylesheet, Image, Media, & Font.*/
-  otherResourceType: 'Other',
-  /** Label for a row in a data table; entries will be the total number and byte size of all third-party resources loaded by a web page. 'Third-party resources are items loaded from URLs that aren't controlled by the owner of the web page. */
-  thirdPartyResourceType: 'Third-party',
-  /** Label used to identify a value in a table where many individual values are aggregated to a single value, for brevity. "Other resources" could also be read as "the rest of the resources". Resource refers to network resources requested by the browser. */
-  otherResourcesLabel: 'Other resources',
-  /** The name of the metric that marks the time at which the first text or image is painted by the browser. Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  firstContentfulPaintMetric: 'First Contentful Paint',
-  /** The name of the metric that marks the time at which the page is fully loaded and is able to quickly respond to user input (clicks, taps, and keypresses feel responsive). Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  interactiveMetric: 'Time to Interactive',
-  /** The name of the metric that marks the time at which a majority of the content has been painted by the browser. Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  firstMeaningfulPaintMetric: 'First Meaningful Paint',
-  /** The name of a metric that calculates the total duration of blocking time for a web page. Blocking times are time periods when the page would be blocked (prevented) from responding to user input (clicks, taps, and keypresses will feel slow to respond). Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  totalBlockingTimeMetric: 'Total Blocking Time',
-  /** The name of the metric "Maximum Potential First Input Delay" that marks the maximum estimated time between the page receiving input (a user clicking, tapping, or typing) and the page responding. Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  maxPotentialFIDMetric: 'Max Potential First Input Delay',
-  /** The name of the metric that summarizes how quickly the page looked visually complete. The name of this metric is largely abstract and can be loosely translated. Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  speedIndexMetric: 'Speed Index',
-  /** The name of the metric that marks the time at which the largest text or image is painted by the browser. Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  largestContentfulPaintMetric: 'Largest Contentful Paint',
-  /** The name of the metric "Cumulative Layout Shift" that indicates how much the page changes its layout while it loads. If big segments of the page shift their location during load, the Cumulative Layout Shift will be higher. Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  cumulativeLayoutShiftMetric: 'Cumulative Layout Shift',
-  /** The name of the "Interaction to Next Paint" metric that measures the time between a user interaction and when the browser displays a response on screen. Shown to users as the label for the numeric metric value. Ideally fits within a ~40 character limit. */
-  interactionToNextPaint: 'Interaction to Next Paint',
-  /** Table item value for the severity of a small, or low impact vulnerability. Part of a ranking scale in the form: low, medium, high. */
-  itemSeverityLow: 'Low',
-  /** Table item value for the severity of a vulnerability. Part of a ranking scale in the form: low, medium, high. */
-  itemSeverityMedium: 'Medium',
-  /** Table item value for the severity of a high impact, or dangerous vulnerability. Part of a ranking scale in the form: low, medium, high. */
-  itemSeverityHigh: 'High',
-};
-
-/**
- * Look up the best available locale for the requested language through these fall backs:
- * - exact match
- * - progressively shorter prefixes (`de-CH-1996` -> `de-CH` -> `de`)
- * - supported locales in Intl formatters
- *
- * If `locale` isn't provided or one could not be found, DEFAULT_LOCALE is returned.
- *
- * By default any of the locales Lighthouse has strings for can be returned, but this
- * can be overriden with `possibleLocales`, useful e.g. when Lighthouse is bundled and
- * only DEFAULT_LOCALE is available, but `possibleLocales` can be used to select a
- * locale available to be downloaded on demand.
- * @param {string|string[]=} locales
- * @param {Array<string>=} possibleLocales
- * @return {LH.Locale}
- */
-function lookupLocale(locales, possibleLocales) {
-  // TODO: lookupLocale may need to be split into two functions, one that canonicalizes
-  // locales and one that looks up the best locale filename for a given locale.
-  // e.g. `en-IE` is canonical, but uses `en-GB.json`. See TODO in locales.js
-
-  if (typeof Intl !== 'object') {
-    // If Node was built with `--with-intl=none`, `Intl` won't exist.
-    throw new Error('Lighthouse must be run in Node with `Intl` support. See https://nodejs.org/api/intl.html for help');
-  }
-
-  const canonicalLocales = Intl.getCanonicalLocales(locales);
-
-  // Filter by what's available in this runtime.
-  const availableLocales = Intl.NumberFormat.supportedLocalesOf(canonicalLocales);
-
-  // Get available locales and transform into object to match `lookupClosestLocale`'s API.
-  const localesWithMessages = possibleLocales || getAvailableLocales();
-  const localesWithmessagesObj = /** @type {Record<LH.Locale, LhlMessages>} */ (
-    Object.fromEntries(localesWithMessages.map(l => [l, {}])));
-
-  const closestLocale = lookupClosestLocale(availableLocales, localesWithmessagesObj);
-
-  if (!closestLocale) {
-    // Log extra info if we're pretty sure this version of Node was built with `--with-intl=small-icu`.
-    if (Intl.NumberFormat.supportedLocalesOf('es').length === 0) {
-      log.warn('i18n', 'Requested locale not available in this version of node. The `full-icu` npm module can provide additional locales. For help, see https://github.com/GoogleChrome/lighthouse/blob/master/readme.md#how-do-i-get-localized-lighthouse-results-via-the-cli');
-    }
-    // eslint-disable-next-line max-len
-    log.warn('i18n', `locale(s) '${locales}' not available. Falling back to default '${DEFAULT_LOCALE}'`);
-  }
-
-  return closestLocale || DEFAULT_LOCALE;
-}
-
-/**
- * Returns a function that generates `LH.IcuMessage` objects to localize the
- * messages in `fileStrings` and the shared `i18n.UIStrings`.
- * @param {string} filename
- * @param {Record<string, string>} fileStrings
- */
-function createIcuMessageFn(filename, fileStrings) {
-  /**
-   * Combined so fn can access both caller's strings and i18n.UIStrings shared across LH.
-   * @type {Record<string, string>}
-   */
-  const mergedStrings = {...UIStrings, ...fileStrings};
-
-  /**
-   * Convert a message string and replacement values into an `LH.IcuMessage`.
-   * @param {string} message
-   * @param {Record<string, string | number>} [values]
-   * @return {LH.IcuMessage}
-   */
-  const getIcuMessageFn = (message, values) => {
-    const keyname = Object.keys(mergedStrings).find(key => mergedStrings[key] === message);
-    if (!keyname) throw new Error(`Could not locate: ${message}`);
-
-    const filenameToLookup = keyname in fileStrings ? filename : __filename;
-    const unixStyleFilename = path.relative(LH_ROOT, filenameToLookup).replace(/\\/g, '/');
-    const i18nId = `${unixStyleFilename} | ${keyname}`;
-
-    return {
-      i18nId,
-      values,
-      formattedDefault: formatMessage(message, values, DEFAULT_LOCALE),
-    };
-  };
-
-  return getIcuMessageFn;
-}
-
-/**
- * Returns true if the given value is a string or an LH.IcuMessage.
- * @param {unknown} value
- * @return {value is string|LH.IcuMessage}
- */
-function isStringOrIcuMessage(value) {
-  return typeof value === 'string' || isIcuMessage(value);
-}
-
-module.exports = {
-  UIStrings,
-  lookupLocale,
-  createIcuMessageFn,
-  isStringOrIcuMessage,
-  // TODO: exported for backwards compatibility. Consider removing on future breaking change.
-  createMessageInstanceIdFn: createIcuMessageFn,
-};