lighthouse 9.6.7 → 10.0.0-dev.20230209

package/lighthouse-core/lib/dependency-graph/simulator/tcp-connection.js

@@ -1,206 +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 INITIAL_CONGESTION_WINDOW = 10;
-const TCP_SEGMENT_SIZE = 1460;
-
-class TcpConnection {
-  /**
-   * @param {number} rtt
-   * @param {number} throughput
-   * @param {number=} serverLatency
-   * @param {boolean=} ssl
-   * @param {boolean=} h2
-   */
-  constructor(rtt, throughput, serverLatency = 0, ssl = true, h2 = false) {
-    this._warmed = false;
-    this._ssl = ssl;
-    this._h2 = h2;
-    this._rtt = rtt;
-    this._throughput = throughput;
-    this._serverLatency = serverLatency;
-    this._congestionWindow = INITIAL_CONGESTION_WINDOW;
-    this._h2OverflowBytesDownloaded = 0;
-  }
-
-  /**
-   * @param {number} rtt
-   * @param {number} availableThroughput
-   * @return {number}
-   */
-  static maximumSaturatedConnections(rtt, availableThroughput) {
-    const roundTripsPerSecond = 1000 / rtt;
-    const bytesPerRoundTrip = TCP_SEGMENT_SIZE;
-    const bytesPerSecond = roundTripsPerSecond * bytesPerRoundTrip;
-    const minimumThroughputRequiredPerRequest = bytesPerSecond * 8;
-    return Math.floor(availableThroughput / minimumThroughputRequiredPerRequest);
-  }
-
-  /**
-   * @return {number}
-   */
-  _computeMaximumCongestionWindowInSegments() {
-    const bytesPerSecond = this._throughput / 8;
-    const secondsPerRoundTrip = this._rtt / 1000;
-    const bytesPerRoundTrip = bytesPerSecond * secondsPerRoundTrip;
-    return Math.floor(bytesPerRoundTrip / TCP_SEGMENT_SIZE);
-  }
-
-  /**
-   * @param {number} throughput
-   */
-  setThroughput(throughput) {
-    this._throughput = throughput;
-  }
-
-  /**
-   * @param {number} congestion
-   */
-  setCongestionWindow(congestion) {
-    this._congestionWindow = congestion;
-  }
-
-  /**
-   * @param {boolean} warmed
-   */
-  setWarmed(warmed) {
-    this._warmed = warmed;
-  }
-
-  /**
-   * @return {boolean}
-   */
-  isWarm() {
-    return this._warmed;
-  }
-
-  /**
-   * @return {boolean}
-   */
-  isH2() {
-    return this._h2;
-  }
-
-  /**
-   * @return {number}
-   */
-  get congestionWindow() {
-    return this._congestionWindow;
-  }
-
-  /**
-   * Sets the number of excess bytes that are available to this connection on future downloads, only
-   * applies to H2 connections.
-   * @param {number} bytes
-   */
-  setH2OverflowBytesDownloaded(bytes) {
-    if (!this._h2) return;
-    this._h2OverflowBytesDownloaded = bytes;
-  }
-
-  /**
-   * @return {TcpConnection}
-   */
-  clone() {
-    return Object.assign(new TcpConnection(this._rtt, this._throughput), this);
-  }
-
-  /**
-   * Simulates a network download of a particular number of bytes over an optional maximum amount of time
-   * and returns information about the ending state.
-   *
-   * See https://hpbn.co/building-blocks-of-tcp/#three-way-handshake and
-   *  https://hpbn.co/transport-layer-security-tls/#tls-handshake for details.
-   *
-   * @param {number} bytesToDownload
-   * @param {DownloadOptions} [options]
-   * @return {DownloadResults}
-   */
-  simulateDownloadUntil(bytesToDownload, options) {
-    const {timeAlreadyElapsed = 0, maximumTimeToElapse = Infinity, dnsResolutionTime = 0} =
-      options || {};
-
-    if (this._warmed && this._h2) {
-      bytesToDownload -= this._h2OverflowBytesDownloaded;
-    }
-    const twoWayLatency = this._rtt;
-    const oneWayLatency = twoWayLatency / 2;
-    const maximumCongestionWindow = this._computeMaximumCongestionWindowInSegments();
-
-    let handshakeAndRequest = oneWayLatency;
-    if (!this._warmed) {
-      handshakeAndRequest =
-        // DNS lookup
-        dnsResolutionTime +
-        // SYN
-        oneWayLatency +
-        // SYN ACK
-        oneWayLatency +
-        // ACK + initial request
-        oneWayLatency +
-        // ClientHello/ServerHello assuming TLS False Start is enabled (https://istlsfastyet.com/#server-performance).
-        (this._ssl ? twoWayLatency : 0);
-    }
-
-    let roundTrips = Math.ceil(handshakeAndRequest / twoWayLatency);
-    let timeToFirstByte = handshakeAndRequest + this._serverLatency + oneWayLatency;
-    if (this._warmed && this._h2) timeToFirstByte = 0;
-
-    const timeElapsedForTTFB = Math.max(timeToFirstByte - timeAlreadyElapsed, 0);
-    const maximumDownloadTimeToElapse = maximumTimeToElapse - timeElapsedForTTFB;
-
-    let congestionWindow = Math.min(this._congestionWindow, maximumCongestionWindow);
-    let totalBytesDownloaded = 0;
-    if (timeElapsedForTTFB > 0) {
-      totalBytesDownloaded = congestionWindow * TCP_SEGMENT_SIZE;
-    } else {
-      roundTrips = 0;
-    }
-
-    let downloadTimeElapsed = 0;
-    let bytesRemaining = bytesToDownload - totalBytesDownloaded;
-    while (bytesRemaining > 0 && downloadTimeElapsed <= maximumDownloadTimeToElapse) {
-      roundTrips++;
-      downloadTimeElapsed += twoWayLatency;
-      congestionWindow = Math.max(Math.min(maximumCongestionWindow, congestionWindow * 2), 1);
-
-      const bytesDownloadedInWindow = congestionWindow * TCP_SEGMENT_SIZE;
-      totalBytesDownloaded += bytesDownloadedInWindow;
-      bytesRemaining -= bytesDownloadedInWindow;
-    }
-
-    const timeElapsed = timeElapsedForTTFB + downloadTimeElapsed;
-    const extraBytesDownloaded = this._h2 ? Math.max(totalBytesDownloaded - bytesToDownload, 0) : 0;
-    const bytesDownloaded = Math.max(Math.min(totalBytesDownloaded, bytesToDownload), 0);
-
-    return {
-      roundTrips,
-      timeElapsed,
-      bytesDownloaded,
-      extraBytesDownloaded,
-      congestionWindow,
-    };
-  }
-}
-
-module.exports = TcpConnection;
-
-/**
- * @typedef DownloadOptions
- * @property {number} [dnsResolutionTime]
- * @property {number} [timeAlreadyElapsed]
- * @property {number} [maximumTimeToElapse]
- */
-
-/**
- * @typedef DownloadResults
- * @property {number} roundTrips
- * @property {number} timeElapsed
- * @property {number} bytesDownloaded
- * @property {number} extraBytesDownloaded
- * @property {number} congestionWindow
- */

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"
-    ```