lighthouse 9.6.8 → 10.0.0

package/lighthouse-core/audits/manual/manual-audit.js

@@ -1,37 +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';
-
-/**
- * @fileoverview Base class for audits that the user should verify manually on
- * their site.
- */
-
-const Audit = require('../audit.js');
-
-class ManualAudit extends Audit {
-  /**
-   * @return {Pick<LH.Audit.Meta, 'scoreDisplayMode'|'requiredArtifacts'>}
-   */
-  static get partialMeta() {
-    return {
-      scoreDisplayMode: Audit.SCORING_MODES.MANUAL,
-      requiredArtifacts: [],
-    };
-  }
-
-  /**
-   * @return {LH.Audit.Product}
-   */
-  static audit() {
-    return {
-      score: 0,
-      // displayValue: '(needs manual verification)'
-    };
-  }
-}
-
-module.exports = ManualAudit;

package/lighthouse-core/audits/manual/pwa-cross-browser.js

@@ -1,41 +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 ManualAudit = require('./manual-audit.js');
-const i18n = require('../../lib/i18n/i18n.js');
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that prompts the user to manually check that their site works across different web browsers. */
-  title: 'Site works cross-browser',
-  /** Description of a Lighthouse audit that tells the user why they should make sites work across different browsers. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'To reach the most number of users, sites should work across ' +
-  'every major browser. [Learn more](https://web.dev/pwa-cross-browser/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @fileoverview Manual PWA audit for cross browser support.
- */
-
-class PWACrossBrowser extends ManualAudit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return Object.assign({
-      id: 'pwa-cross-browser',
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-    }, super.partialMeta);
-  }
-}
-
-module.exports = PWACrossBrowser;
-module.exports.UIStrings = UIStrings;
-

package/lighthouse-core/audits/manual/pwa-each-page-has-url.js

@@ -1,39 +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 ManualAudit = require('./manual-audit.js');
-const i18n = require('../../lib/i18n/i18n.js');
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that prompts the user to manually check that each page on their website uses a unique URL. */
-  title: 'Each page has a URL',
-  /** Description of a Lighthouse audit that tells the user why they should use unique URLs for each web page. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Ensure individual pages are deep linkable via URL and that URLs are ' +
-      'unique for the purpose of shareability on social media. [Learn more](https://web.dev/pwa-each-page-has-url/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @fileoverview Manual PWA audit to ensure every page has a deep link.
- */
-
-class PWAEachPageHasURL extends ManualAudit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return Object.assign({
-      id: 'pwa-each-page-has-url',
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-    }, super.partialMeta);
-  }
-}
-
-module.exports = PWAEachPageHasURL;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/manual/pwa-page-transitions.js

@@ -1,39 +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 ManualAudit = require('./manual-audit.js');
-const i18n = require('../../lib/i18n/i18n.js');
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that prompts the user to manually check that page transitions (navigating to other pages on a website) shouldn't feel like they are waiting for the network to load. */
-  title: 'Page transitions don\'t feel like they block on the network',
-  /** Description of a Lighthouse audit that tells the user why they should make transitions in their web app feel fast. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Transitions should feel snappy as you tap around, even on a slow network. ' +
-    'This experience is key to a user\'s perception of performance. [Learn more](https://web.dev/pwa-page-transitions/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @fileoverview Manual PWA audit for janky-free page transitions.
- */
-
-class PWAPageTransitions extends ManualAudit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return Object.assign({
-      id: 'pwa-page-transitions',
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-    }, super.partialMeta);
-  }
-}
-
-module.exports = PWAPageTransitions;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/maskable-icon.js

@@ -1,71 +0,0 @@
-/**
- * @license Copyright 2020 The Lighthouse Authors. All Rights Reserved.
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
- */
-'use strict';
-
-const Audit = require('./audit.js');
-const ManifestValues = require('../computed/manifest-values.js');
-const i18n = require('../lib/i18n/i18n.js');
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that provides detail on if the manifest contains a maskable icon. This descriptive title is shown to users when the manifest contains at least one maskable icon. */
-  title: 'Manifest has a maskable icon',
-  /** Title of a Lighthouse audit that provides detial on if the manifest contains a maskable icon. this descriptive title is shown to users when the manifest contains no icons that are maskable. */
-  failureTitle: 'Manifest doesn\'t have a maskable icon',
-  /** Description of a Lighthouse audit that tells the user why they their manifest should have at least one maskable icon. This is displayed after a user expands the section to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'A maskable icon ensures that the image fills the entire ' +
-    'shape without being letterboxed when installing ' +
-    'the app on a device. [Learn more](https://web.dev/maskable-icon-audit/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @fileoverview
- * Audits if a manifest contains at least one icon that is maskable
- *
- * Requirements:
- *    * manifest is not empty
- *    * manifest has valid icons
- *    * at least one of the icons has a purpose of 'maskable'
- */
-
-class MaskableIcon extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'maskable-icon',
-      title: str_(UIStrings.title),
-      failureTitle: str_(UIStrings.failureTitle),
-      description: str_(UIStrings.description),
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['WebAppManifest', 'InstallabilityErrors'],
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const manifestValues = await ManifestValues.request(artifacts, context);
-    if (manifestValues.isParseFailure) {
-      return {
-        score: 0,
-        explanation: manifestValues.parseFailureReason,
-      };
-    }
-    const maskableIconCheck = manifestValues.allChecks.find(i => i.id === 'hasMaskableIcon');
-    return {
-      score: maskableIconCheck?.passing ? 1 : 0,
-    };
-  }
-}
-
-module.exports = MaskableIcon;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/metrics/cumulative-layout-shift.js

@@ -1,79 +0,0 @@
-/**
- * @license Copyright 2019 The Lighthouse Authors. All Rights Reserved.
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
- */
-'use strict';
-
-const Audit = require('../audit.js');
-const ComputedCLS = require('../../computed/metrics/cumulative-layout-shift.js');
-const i18n = require('../../lib/i18n/i18n.js');
-
-const UIStrings = {
-  /** Description of the Cumulative Layout Shift metric 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. This description is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Cumulative Layout Shift measures the movement of visible ' +
-               'elements within the viewport. [Learn more](https://web.dev/cls/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @fileoverview This metric represents the amount of visual shifting of DOM elements during page load.
- */
-class CumulativeLayoutShift extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'cumulative-layout-shift',
-      title: str_(i18n.UIStrings.cumulativeLayoutShiftMetric),
-      description: str_(UIStrings.description),
-      scoreDisplayMode: Audit.SCORING_MODES.NUMERIC,
-      requiredArtifacts: ['traces'],
-    };
-  }
-
-  /**
-   * @return {LH.Audit.ScoreOptions}
-   */
-  static get defaultOptions() {
-    return {
-      // https://web.dev/cls/#what-is-a-good-cls-score
-      // This 0.1 target score was determined through both manual evaluation and large-scale analysis.
-      // see https://www.desmos.com/calculator/ksp7q91nop
-      p10: 0.1,
-      median: 0.25,
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const trace = artifacts.traces[Audit.DEFAULT_PASS];
-    const {cumulativeLayoutShift, ...rest} = await ComputedCLS.request(trace, context);
-
-    /** @type {LH.Audit.Details.DebugData} */
-    const details = {
-      type: 'debugdata',
-      items: [rest],
-    };
-
-    return {
-      score: Audit.computeLogNormalScore(
-        {p10: context.options.p10, median: context.options.median},
-        cumulativeLayoutShift
-      ),
-      numericValue: cumulativeLayoutShift,
-      numericUnit: 'unitless',
-      displayValue: cumulativeLayoutShift.toLocaleString(context.settings.locale),
-      details,
-    };
-  }
-}
-
-module.exports = CumulativeLayoutShift;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/metrics/experimental-interaction-to-next-paint.js

@@ -1,88 +0,0 @@
-/**
- * @license Copyright 2022 The Lighthouse Authors. All Rights Reserved.
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
- */
-'use strict';
-
-const Audit = require('../audit.js');
-const ComputedResponsivenes = require('../../computed/metrics/responsiveness.js');
-const i18n = require('../../lib/i18n/i18n.js');
-
-const UIStrings = {
-  /** Description of the Interaction to Next Paint metric. This description is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'Interaction to Next Paint measures page responsiveness, how long it ' +
-               'takes the page to visibly respond to user input. [Learn more](https://web.dev/inp/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @fileoverview This metric gives a high-percentile measure of responsiveness to input.
- */
-class ExperimentalInteractionToNextPaint extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'experimental-interaction-to-next-paint',
-      title: str_(i18n.UIStrings.interactionToNextPaint),
-      description: str_(UIStrings.description),
-      scoreDisplayMode: Audit.SCORING_MODES.NUMERIC,
-      supportedModes: ['timespan'],
-      requiredArtifacts: ['traces'],
-    };
-  }
-
-  /**
-   * @return {LH.Audit.ScoreOptions}
-   */
-  static get defaultOptions() {
-    return {
-      // https://web.dev/inp/
-      // This is using the same threshold as field tools since only supported in
-      // unsimulated user flows for now.
-      // see https://www.desmos.com/calculator/4xtrhg51th
-      p10: 200,
-      median: 500,
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const {settings} = context;
-    // TODO: responsiveness isn't yet supported by lantern.
-    if (settings.throttlingMethod === 'simulate') {
-      return {score: null, notApplicable: true};
-    }
-
-    const trace = artifacts.traces[Audit.DEFAULT_PASS];
-    const metricData = {trace, settings};
-    const interactionEvent = await ComputedResponsivenes.request(metricData, context);
-
-    // TODO: include the no-interaction state in the report instead of using n/a.
-    if (interactionEvent === null) {
-      return {score: null, notApplicable: true};
-    }
-
-    // TODO: remove workaround once 103.0.5052.0 is sufficiently released.
-    const timing = interactionEvent.name === 'FallbackTiming' ?
-        interactionEvent.duration : interactionEvent.args.data.duration;
-
-    return {
-      score: Audit.computeLogNormalScore({p10: context.options.p10, median: context.options.median},
-        timing),
-      numericValue: timing,
-      numericUnit: 'millisecond',
-      displayValue: str_(i18n.UIStrings.ms, {timeInMs: timing}),
-    };
-  }
-}
-
-module.exports = ExperimentalInteractionToNextPaint;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/metrics/first-contentful-paint-3g.js

@@ -1,67 +0,0 @@
-/**
- * @license Copyright 2019 The Lighthouse Authors. All Rights Reserved.
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
- */
-'use strict';
-
-const Audit = require('../audit.js');
-const regular3G = require('../../config/constants.js').throttling.mobileRegular3G;
-const ComputedFcp = require('../../computed/metrics/first-contentful-paint.js');
-
-class FirstContentfulPaint3G extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'first-contentful-paint-3g',
-      title: 'First Contentful Paint (3G)',
-      description: 'First Contentful Paint 3G marks the time at which the first text or image is ' +
-        `painted while on a 3G network. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/first-contentful-paint).`,
-      scoreDisplayMode: Audit.SCORING_MODES.NUMERIC,
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['traces', 'devtoolsLogs', 'GatherContext'],
-    };
-  }
-
-  /**
-   * @return {LH.Audit.ScoreOptions}
-   */
-  static get defaultOptions() {
-    return {
-      // 25th and 8th percentiles HTTPArchive on Slow 4G -> multiply by 1.5 for RTT differential -> median and p10.
-      // https://bigquery.cloud.google.com/table/httparchive:lighthouse.2021_05_01_mobile
-      // https://www.desmos.com/calculator/xi5oympawp
-      p10: 2700,
-      median: 4500,
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const gatherContext = artifacts.GatherContext;
-    const trace = artifacts.traces[Audit.DEFAULT_PASS];
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    /** @type {Immutable<LH.Config.Settings>} */
-    const settings = {...context.settings, throttlingMethod: 'simulate', throttling: regular3G};
-    const metricComputationData = {trace, devtoolsLog, gatherContext, settings};
-    const metricResult = await ComputedFcp.request(metricComputationData, context);
-
-    return {
-      score: Audit.computeLogNormalScore(
-        {p10: context.options.p10, median: context.options.median},
-        metricResult.timing
-      ),
-      numericValue: metricResult.timing,
-      numericUnit: 'millisecond',
-      displayValue: `${metricResult.timing}\xa0ms`,
-    };
-  }
-}
-
-module.exports = FirstContentfulPaint3G;

package/lighthouse-core/audits/metrics/first-contentful-paint.js

@@ -1,85 +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';
-
-const Audit = require('../audit.js');
-const i18n = require('../../lib/i18n/i18n.js');
-const ComputedFcp = require('../../computed/metrics/first-contentful-paint.js');
-
-const UIStrings = {
-  /** Description of the First Contentful Paint (FCP) metric, which marks the time at which the first text or image is painted by the browser. This is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'First Contentful Paint marks the time at which the first text or image is ' +
-      `painted. [Learn more](https://web.dev/first-contentful-paint/).`,
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-class FirstContentfulPaint extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'first-contentful-paint',
-      title: str_(i18n.UIStrings.firstContentfulPaintMetric),
-      description: str_(UIStrings.description),
-      scoreDisplayMode: Audit.SCORING_MODES.NUMERIC,
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['traces', 'devtoolsLogs', 'GatherContext'],
-    };
-  }
-
-  /**
-   * @return {{mobile: {scoring: LH.Audit.ScoreOptions}, desktop: {scoring: LH.Audit.ScoreOptions}}}
-   */
-  static get defaultOptions() {
-    return {
-      mobile: {
-        // 25th and 8th percentiles HTTPArchive -> median and p10.
-        // https://bigquery.cloud.google.com/table/httparchive:lighthouse.2021_05_01_mobile
-        // see https://www.desmos.com/calculator/6wi8rhipve
-        scoring: {
-          p10: 1800,
-          median: 3000,
-        },
-      },
-      desktop: {
-        // SELECT QUANTILES(renderStart, 21) FROM [httparchive:summary_pages.2020_07_01_desktop] LIMIT 1000
-        scoring: {
-          p10: 934,
-          median: 1600,
-        },
-      },
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const trace = artifacts.traces[Audit.DEFAULT_PASS];
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    const gatherContext = artifacts.GatherContext;
-    const metricComputationData = {trace, devtoolsLog, gatherContext, settings: context.settings};
-    const metricResult = await ComputedFcp.request(metricComputationData, context);
-    const options = context.options[context.settings.formFactor];
-
-    return {
-      score: Audit.computeLogNormalScore(
-        options.scoring,
-        metricResult.timing
-      ),
-      numericValue: metricResult.timing,
-      numericUnit: 'millisecond',
-      displayValue: str_(i18n.UIStrings.seconds, {timeInMs: metricResult.timing}),
-    };
-  }
-}
-
-module.exports = FirstContentfulPaint;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/metrics/first-meaningful-paint.js

@@ -1,89 +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 Audit = require('../audit.js');
-const i18n = require('../../lib/i18n/i18n.js');
-const ComputedFmp = require('../../computed/metrics/first-meaningful-paint.js');
-
-const UIStrings = {
-  /** Description of the First Meaningful Paint (FMP) metric, which marks the time at which a majority of the content has been painted by the browser. This is displayed within a tooltip when the user hovers on the metric name to see more. No character length limits. 'Learn More' becomes link text to additional documentation. */
-  description: 'First Meaningful Paint measures when the primary content of a page is ' +
-      'visible. [Learn more](https://web.dev/first-meaningful-paint/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-class FirstMeaningfulPaint extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'first-meaningful-paint',
-      title: str_(i18n.UIStrings.firstMeaningfulPaintMetric),
-      description: str_(UIStrings.description),
-      scoreDisplayMode: Audit.SCORING_MODES.NUMERIC,
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['traces', 'devtoolsLogs', 'GatherContext'],
-    };
-  }
-
-  /**
-   * @return {{mobile: {scoring: LH.Audit.ScoreOptions}, desktop: {scoring: LH.Audit.ScoreOptions}}}
-   */
-  static get defaultOptions() {
-    return {
-      mobile: {
-        // 25th and 5th percentiles HTTPArchive -> median and PODR, then p10 derived from them.
-        // https://bigquery.cloud.google.com/table/httparchive:lighthouse.2018_04_01_mobile?pli=1
-        // see https://www.desmos.com/calculator/i4znkdccut
-        scoring: {
-          p10: 2336,
-          median: 4000,
-        },
-      },
-      desktop: {
-        // SELECT QUANTILES(renderStart, 21) FROM [httparchive:summary_pages.2018_12_15_desktop] LIMIT 1000
-        scoring: {
-          p10: 934,
-          median: 1600,
-        },
-      },
-    };
-  }
-
-  /**
-   * Audits the page to give a score for First Meaningful Paint.
-   * @see https://github.com/GoogleChrome/lighthouse/issues/26
-   * @see https://docs.google.com/document/d/1BR94tJdZLsin5poeet0XoTW60M0SjvOJQttKT-JK8HI/view
-   * @param {LH.Artifacts} artifacts The artifacts from the gather phase.
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const trace = artifacts.traces[Audit.DEFAULT_PASS];
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    const gatherContext = artifacts.GatherContext;
-    const metricComputationData = {trace, devtoolsLog, gatherContext, settings: context.settings};
-    const metricResult = await ComputedFmp.request(metricComputationData, context);
-    const options = context.options[context.settings.formFactor];
-
-
-    return {
-      score: Audit.computeLogNormalScore(
-        options.scoring,
-        metricResult.timing
-      ),
-      numericValue: metricResult.timing,
-      numericUnit: 'millisecond',
-      displayValue: str_(i18n.UIStrings.seconds, {timeInMs: metricResult.timing}),
-    };
-  }
-}
-
-module.exports = FirstMeaningfulPaint;
-module.exports.UIStrings = UIStrings;