lighthouse 9.6.7 → 10.0.0

package/lighthouse-core/audits/server-response-time.js

@@ -1,106 +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 Audit = require('./audit.js');
-const i18n = require('../lib/i18n/i18n.js');
-const MainResource = require('../computed/main-resource.js');
-const NetworkRecords = require('../computed/network-records.js');
-const NetworkAnalyzer = require('../lib/dependency-graph/simulator/network-analyzer.js');
-
-const UIStrings = {
-  /** Title of a diagnostic audit that provides detail on how long it took from starting a request to when the server started responding. This descriptive title is shown to users when the amount is acceptable and no user action is required. */
-  title: 'Initial server response time was short',
-  /** Title of a diagnostic audit that provides detail on how long it took from starting a request to when the server started responding. This imperative title is shown to users when there is a significant amount of execution time that could be reduced. */
-  failureTitle: 'Reduce initial server response time',
-  /** Description of a Lighthouse audit that tells the user *why* they should reduce the amount of time it takes their server to start responding to requests. 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: 'Keep the server response time for the main document short because all other requests depend on it. [Learn more](https://web.dev/time-to-first-byte/).',
-  /** Used to summarize the total Server Response Time duration for the primary HTML response. The `{timeInMs}` placeholder will be replaced with the time duration, shown in milliseconds (e.g. 210 ms) */
-  displayValue: `Root document took {timeInMs, number, milliseconds}\xa0ms`,
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-// Due to the way that DevTools throttling works we cannot see if server response took less than ~570ms.
-// We set our failure threshold to 600ms to avoid those false positives but we want devs to shoot for 100ms.
-const TOO_SLOW_THRESHOLD_MS = 600;
-const TARGET_MS = 100;
-
-class ServerResponseTime extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'server-response-time',
-      title: str_(UIStrings.title),
-      failureTitle: str_(UIStrings.failureTitle),
-      description: str_(UIStrings.description),
-      supportedModes: ['timespan', 'navigation'],
-      requiredArtifacts: ['devtoolsLogs', 'URL', 'GatherContext'],
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts.NetworkRequest} record
-   */
-  static calculateResponseTime(record) {
-    const timing = record.timing;
-    return timing ? timing.receiveHeadersEnd - timing.sendEnd : 0;
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-
-    /** @type {LH.Artifacts.NetworkRequest} */
-    let mainResource;
-    if (artifacts.GatherContext.gatherMode === 'timespan') {
-      const networkRecords = await NetworkRecords.request(devtoolsLog, context);
-      const optionalMainResource = NetworkAnalyzer.findOptionalMainDocument(
-        networkRecords,
-        artifacts.URL.finalUrl
-      );
-      if (!optionalMainResource) {
-        return {score: null, notApplicable: true};
-      }
-      mainResource = optionalMainResource;
-    } else {
-      mainResource = await MainResource.request({devtoolsLog, URL: artifacts.URL}, context);
-    }
-
-    const responseTime = ServerResponseTime.calculateResponseTime(mainResource);
-    const passed = responseTime < TOO_SLOW_THRESHOLD_MS;
-    const displayValue = str_(UIStrings.displayValue, {timeInMs: responseTime});
-
-    /** @type {LH.Audit.Details.Opportunity['headings']} */
-    const headings = [
-      {key: 'url', valueType: 'url', label: str_(i18n.UIStrings.columnURL)},
-      {key: 'responseTime', valueType: 'timespanMs', label: str_(i18n.UIStrings.columnTimeSpent)},
-    ];
-
-    const details = Audit.makeOpportunityDetails(
-      headings,
-      [{url: mainResource.url, responseTime}],
-      responseTime - TARGET_MS
-    );
-
-    return {
-      numericValue: responseTime,
-      numericUnit: 'millisecond',
-      score: Number(passed),
-      displayValue,
-      details,
-    };
-  }
-}
-
-module.exports = ServerResponseTime;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/service-worker.js

@@ -1,179 +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 URL = require('../lib/url-shim.js');
-const Audit = require('./audit.js');
-const i18n = require('../lib/i18n/i18n.js');
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that provides detail on a page's service worker. This descriptive title is shown to users when a service worker is registered and valid. */
-  title: 'Registers a service worker that controls page and `start_url`',
-  /** Title of a Lighthouse audit that provides detail on a page's service worker. This descriptive title is shown to users when a service worker is not present or invalid. */
-  failureTitle: 'Does not register a service worker that controls page and `start_url`',
-  /** Description of a Lighthouse audit that tells the user why they should use a service worker. 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: 'The service worker is the technology that enables your app to use many ' +
-    'Progressive Web App features, such as offline, add to homescreen, and push ' +
-    'notifications. [Learn more](https://web.dev/service-worker/).',
-  /**
-   * @description Message explaining that the website may have service workers, but none are in scope to control the tested web page.
-   * @example {https://example.com/} pageUrl
-   * */
-  explanationOutOfScope: 'This origin has one or more service workers, however the page ' +
-    '({pageUrl}) is not in scope.',
-  /** Message explaining that the page has no manifest file so can't specify a starting url. */
-  explanationNoManifest: 'This page is controlled by a service worker, however ' +
-    'no `start_url` was found because no manifest was fetched.',
-  /** Message explaining that the page had an invalid manifest file so can't specify a starting url. */
-  explanationBadManifest: 'This page is controlled by a service worker, however ' +
-    'no `start_url` was found because manifest failed to parse as valid JSON',
-  /**
-   * @description Message explaining that the website has a service worker, but none are in scope to control the tested starting url.
-   * @example {https://example.com/} startUrl
-   * @example {https://othersite.com/} scopeUrl
-   * */
-  explanationBadStartUrl: 'This page is controlled by a service worker, however ' +
-    'the `start_url` ({startUrl}) is not in the service worker\'s scope ({scopeUrl})',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-class ServiceWorker extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'service-worker',
-      title: str_(UIStrings.title),
-      failureTitle: str_(UIStrings.failureTitle),
-      description: str_(UIStrings.description),
-      requiredArtifacts: ['URL', 'ServiceWorker', 'WebAppManifest'],
-    };
-  }
-
-  /**
-   * Find active service workers for this origin.
-   * @param {Array<LH.Crdp.ServiceWorker.ServiceWorkerVersion>} versions
-   * @param {URL} pageUrl
-   * @return {Array<LH.Crdp.ServiceWorker.ServiceWorkerVersion>}
-   */
-  static getVersionsForOrigin(versions, pageUrl) {
-    return versions
-      .filter(v => v.status === 'activated')
-      .filter(v => new URL(v.scriptURL).origin === pageUrl.origin);
-  }
-
-  /**
-   * From the set of active service workers for this origin, find the controlling SW (if any)
-   * and return its scope URL.
-   * @param {Array<LH.Crdp.ServiceWorker.ServiceWorkerVersion>} matchingSWVersions
-   * @param {Array<LH.Crdp.ServiceWorker.ServiceWorkerRegistration>} registrations
-   * @param {URL} pageUrl
-   * @return {{scopeUrl: string; scriptUrl: string} | undefined}
-   */
-  static getControllingServiceWorker(matchingSWVersions, registrations, pageUrl) {
-    // Find the normalized scope URLs of possibly-controlling SWs.
-    /** @type {Array<{scopeUrl: string; scriptUrl: string}>} */
-    const scriptByScopeUrlList = [];
-
-    // Populate serviceWorkerUrls map with the scriptURLs and scopeUrls of matchingSWVersions and registrations
-    for (const version of matchingSWVersions) {
-      const matchedRegistration = registrations
-        .find(r => r.registrationId === version.registrationId);
-
-      if (matchedRegistration) {
-        const scopeUrl = new URL(matchedRegistration.scopeURL).href;
-        const scriptUrl = new URL(version.scriptURL).href;
-        scriptByScopeUrlList.push({scopeUrl, scriptUrl});
-      }
-    }
-
-    // Find most-specific applicable scope, the one controlling the page.
-    // See https://w3c.github.io/ServiceWorker/v1/#scope-match-algorithm
-    const pageControllingUrls = scriptByScopeUrlList
-      .filter(ss => pageUrl.href.startsWith(ss.scopeUrl))
-      .sort((ssA, ssB) => ssA.scopeUrl.length - ssB.scopeUrl.length)
-      .pop();
-
-    return pageControllingUrls;
-  }
-
-  /**
-   * Returns a failure message if there is no start_url or if the start_url isn't
-   * contolled by the scopeUrl.
-   * @param {LH.Artifacts['WebAppManifest']} WebAppManifest
-   * @param {string} scopeUrl
-   * @return {LH.IcuMessage|undefined}
-   */
-  static checkStartUrl(WebAppManifest, scopeUrl) {
-    if (!WebAppManifest) {
-      return str_(UIStrings.explanationNoManifest);
-    }
-    if (!WebAppManifest.value) {
-      return str_(UIStrings.explanationBadManifest);
-    }
-
-    const startUrl = WebAppManifest.value.start_url.value;
-    if (!startUrl.startsWith(scopeUrl)) {
-      return str_(UIStrings.explanationBadStartUrl, {startUrl, scopeUrl});
-    }
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @return {LH.Audit.Product}
-   */
-  static audit(artifacts) {
-    // Match against artifacts.URL.finalUrl so audit accounts for any redirects.
-    const pageUrl = new URL(artifacts.URL.finalUrl);
-    const {versions, registrations} = artifacts.ServiceWorker;
-
-    const versionsForOrigin = ServiceWorker.getVersionsForOrigin(versions, pageUrl);
-    if (versionsForOrigin.length === 0) {
-      return {
-        score: 0,
-      };
-    }
-
-    const serviceWorkerUrls = ServiceWorker.getControllingServiceWorker(versionsForOrigin,
-        registrations, pageUrl);
-    if (!serviceWorkerUrls) {
-      return {
-        score: 0,
-        explanation: str_(UIStrings.explanationOutOfScope, {pageUrl: pageUrl.href}),
-      };
-    }
-
-    // Include the SW details as diagnostic data.
-    const {scriptUrl, scopeUrl} = serviceWorkerUrls;
-    /** @type {LH.Audit.Details.DebugData} */
-    const details = {
-      type: 'debugdata',
-      scriptUrl,
-      scopeUrl,
-    };
-
-    const startUrlFailure = ServiceWorker.checkStartUrl(artifacts.WebAppManifest,
-      serviceWorkerUrls.scopeUrl);
-    if (startUrlFailure) {
-      return {
-        score: 0,
-        details,
-        explanation: startUrlFailure,
-      };
-    }
-
-    // SW controls both finalUrl and start_url.
-    return {
-      score: 1,
-      details,
-    };
-  }
-}
-
-module.exports = ServiceWorker;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/splash-screen.js

@@ -1,99 +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 MultiCheckAudit = require('./multi-check-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 splash screens. This descriptive title is shown to users when the site has a custom splash screen. */
-  title: 'Configured for a custom splash screen',
-  /** Title of a Lighthouse audit that provides detail on splash screens. This descriptive title is shown to users when the site does not have a custom splash screen. */
-  failureTitle: 'Is not configured for a custom splash screen',
-  /** Description of a Lighthouse audit that tells the user why they should configure a custom splash screen. 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 themed splash screen ensures a high-quality experience when ' +
-    'users launch your app from their homescreens. [Learn ' +
-    'more](https://web.dev/splash-screen/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @fileoverview
- * Audits if a page is configured for a custom splash screen when launched
- * https://github.com/GoogleChrome/lighthouse/issues/24
- *
- * Requirements:
- *   * manifest is not empty
- *   * manifest has a valid name
- *   * manifest has a valid background_color
- *   * manifest has a valid theme_color
- *   * manifest contains icon that's a png and size >= 512px
- */
-
-class SplashScreen extends MultiCheckAudit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'splash-screen',
-      title: str_(UIStrings.title),
-      failureTitle: str_(UIStrings.failureTitle),
-      description: str_(UIStrings.description),
-      supportedModes: ['navigation'],
-      requiredArtifacts: ['WebAppManifest', 'InstallabilityErrors'],
-    };
-  }
-
-  /**
-   * @param {LH.Artifacts.ManifestValues} manifestValues
-   * @param {Array<string>} failures
-   */
-  static assessManifest(manifestValues, failures) {
-    if (manifestValues.isParseFailure && manifestValues.parseFailureReason) {
-      failures.push(manifestValues.parseFailureReason);
-      return;
-    }
-
-    const splashScreenCheckIds = [
-      'hasName',
-      'hasBackgroundColor',
-      'hasThemeColor',
-      'hasIconsAtLeast512px',
-    ];
-
-    manifestValues.allChecks
-      .filter(item => splashScreenCheckIds.includes(item.id))
-      .forEach(item => {
-        if (!item.passing) {
-          failures.push(item.failureText);
-        }
-      });
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<{failures: Array<string>, manifestValues: LH.Artifacts.ManifestValues}>}
-   */
-  static async audit_(artifacts, context) {
-    /** @type {Array<string>} */
-    const failures = [];
-
-    const manifestValues = await ManifestValues.request(artifacts, context);
-    SplashScreen.assessManifest(manifestValues, failures);
-
-    return {
-      failures,
-      manifestValues,
-    };
-  }
-}
-
-module.exports = SplashScreen;
-module.exports.UIStrings = UIStrings;

package/lighthouse-core/audits/themed-omnibox.js

@@ -1,110 +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 MultiCheckAudit = require('./multi-check-audit.js');
-const ManifestValues = require('../computed/manifest-values.js');
-const cssParsers = require('cssstyle/lib/parsers');
-const i18n = require('../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. 'Learn More' becomes link text to additional documentation. */
-  description: 'The browser address bar can be themed to match your site. ' +
-    '[Learn more](https://web.dev/themed-omnibox/).',
-};
-
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
-
-/**
- * @fileoverview
- * Audits if a page is configured for a themed address bar
- *
- * Requirements:
- *   * manifest is not empty
- *   * manifest has a valid theme_color
- *   * HTML has a valid theme-color meta
- */
-
-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 {string} color
-   * @return {boolean}
-   */
-  static isValidColor(color) {
-    return cssParsers.valueType(color) === cssParsers.TYPES.COLOR;
-  }
-
-  /**
-   * @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 (!ThemedOmnibox.isValidColor(themeColorMeta.content || '')) {
-      failures.push('The theme-color meta tag did not contain a valid CSS color');
-    }
-  }
-
-  /**
-   * @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,
-    };
-  }
-}
-
-module.exports = ThemedOmnibox;
-module.exports.UIStrings = UIStrings;