lighthouse 12.2.3-dev.20241211 → 12.2.3

package/shared/localization/locales/zh.json

@@ -2621,66 +2621,6 @@
   "flow-report/src/i18n/ui-strings.js | title": {
     "message": "Lighthouse 用户流报告"
   },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/CLSCulprits.js | description": {
-    "message": "当元素在没有任何用户互动的情况下移动时，就会发生布局偏移。[调查布局偏移的原因](https://web.dev/articles/optimize-cls)，例如在网页加载时添加、移除元素或元素字体发生了变化。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/CLSCulprits.js | title": {
-    "message": "布局偏移原因"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/DocumentLatency.js | description": {
-    "message": "您的第一个网络请求最为重要。您可通过避免重定向、确保服务器快速响应以及启用文本压缩，缩短其延迟时间。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/DocumentLatency.js | title": {
-    "message": "文档请求延迟"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/FontDisplay.js | description": {
-    "message": "建议您将 [font-display](https://developer.chrome.com/blog/font-display) 设为 swap 或 optional，确保文本始终可见。通过[替换字体指标](https://developer.chrome.com/blog/font-fallbacks)可进一步优化 swap，缓解布局偏移。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/FontDisplay.js | title": {
-    "message": "字体显示"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/InteractionToNextPaint.js | description": {
-    "message": "请从持续时间最长的阶段开始检查。[几处延迟可降低到最小](https://web.dev/articles/optimize-inp#optimize_interactions)。如需缩短处理时长，请[优化主线程（通常是 JS）成本](https://web.dev/articles/optimize-long-tasks)。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/InteractionToNextPaint.js | title": {
-    "message": "按阶段划分的 INP"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/LCPDiscovery.js | description": {
-    "message": "使 LCP 图像能够立即从 HTML 中[被发现](https://web.dev/articles/optimize-lcp#1_eliminate_resource_load_delay)，并[避免延迟加载](https://web.dev/articles/lcp-lazy-loading)，以此优化 LCP"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/LCPDiscovery.js | title": {
-    "message": "发现 LCP 请求"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/LCPPhases.js | description": {
-    "message": "每个[阶段都有特定的改进策略](https://web.dev/articles/optimize-lcp#lcp-breakdown)。理想情况下，大部分 LCP 时间应该花在加载资源上，而不是浪费在延迟上。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/LCPPhases.js | title": {
-    "message": "按阶段划分的 LCP"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/RenderBlocking.js | description": {
-    "message": "请求正在屏蔽网页的初始渲染，这可能会延迟 LCP。[延迟或内嵌](https://web.dev/learn/performance/understanding-the-critical-path#render-blocking_resources/)可以将这些网络请求移出关键路径。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/RenderBlocking.js | title": {
-    "message": "渲染屏蔽请求"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/SlowCSSSelector.js | description": {
-    "message": "如果“重新计算样式”的成本仍然很高，优化选择器可以降低此成本。请对用时较长及慢路径所占百分比较高的[选择器进行优化](https://developer.chrome.com/docs/devtools/performance/selector-stats)。选择器越简单、数量越少，DOM 的规模越小、结构越简单，越能降低匹配成本。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/SlowCSSSelector.js | title": {
-    "message": "CSS 选择器成本"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/ThirdParties.js | description": {
-    "message": "第三方代码可能会显著影响加载性能。[请减少并推迟加载第三方代码](https://developers.google.com/web/fundamentals/performance/optimizing-content-efficiency/loading-third-party-javascript/)，以优先渲染您的网页内容。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/ThirdParties.js | title": {
-    "message": "第三方"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/Viewport.js | description": {
-    "message": "此网页的视口未针对移动设备进行优化，因此点按互动可能会[延迟最多 300 毫秒](https://developer.chrome.com/blog/300ms-tap-delay-gone-away/)。"
-  },
-  "node_modules/@paulirish/trace_engine/models/trace/insights/Viewport.js | title": {
-    "message": "视口未针对移动设备进行优化"
-  },
   "node_modules/lighthouse-stack-packs/packs/amp.js | efficient-animated-content": {
     "message": "对于动画内容，请使用 [`amp-anim`](https://amp.dev/documentation/components/amp-anim/) 尽量减少当内容在屏幕外时的 CPU 使用量。"
   },

package/types/artifacts.d.ts

@@ -510,8 +510,8 @@ declare module Artifacts {
   }
 
   interface TraceEngineResult {
-    data: TraceEngine.Handlers.Types.ParsedTrace;
-    insights: TraceEngine.Insights.Types.TraceInsightSets;
+    data: TraceEngine.Handlers.Types.TraceParseData;
+    insights: TraceEngine.Insights.Types.TraceInsightData;
   }
 
   interface TraceEngineRootCauses {

package/core/audits/has-hsts.d.ts

@@ -1,44 +0,0 @@
-export default HasHsts;
-declare class HasHsts extends Audit {
-    /**
-     * @param {LH.Artifacts} artifacts
-     * @param {LH.Audit.Context} context
-     * @return {Promise<string[]>}
-     */
-    static getRawHsts(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<string[]>;
-    /**
-     * @param {string} hstsDirective
-     * @param {LH.IcuMessage | string} findingDescription
-     * @param {LH.IcuMessage=} severity
-     * @return {LH.Audit.Details.TableItem}
-     */
-    static findingToTableItem(hstsDirective: string, findingDescription: LH.IcuMessage | string, severity?: LH.IcuMessage | undefined): LH.Audit.Details.TableItem;
-    /**
-     * @param {string[]} hstsHeaders
-     * @return {{score: number, results: LH.Audit.Details.TableItem[]}}
-     */
-    static constructResults(hstsHeaders: string[]): {
-        score: number;
-        results: LH.Audit.Details.TableItem[];
-    };
-    /**
-     * @param {LH.Artifacts} artifacts
-     * @param {LH.Audit.Context} context
-     * @return {Promise<LH.Audit.Product>}
-     */
-    static audit(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<LH.Audit.Product>;
-}
-export namespace UIStrings {
-    let title: string;
-    let description: string;
-    let noHsts: string;
-    let noPreload: string;
-    let noSubdomain: string;
-    let noMaxAge: string;
-    let lowMaxAge: string;
-    let invalidSyntax: string;
-    let columnDirective: string;
-    let columnSeverity: string;
-}
-import { Audit } from './audit.js';
-//# sourceMappingURL=has-hsts.d.ts.map

package/core/audits/has-hsts.js

@@ -1,208 +0,0 @@
-/**
- * @license
- * Copyright 2024 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import {Audit} from './audit.js';
-import {MainResource} from '../computed/main-resource.js';
-import * as i18n from '../lib/i18n/i18n.js';
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that evaluates the security of a page's HSTS header. "HSTS" stands for "HTTP Strict Transport Security". */
-  title: 'Use a strong HSTS policy',
-  /** Description of a Lighthouse audit that evaluates the security of a page's HSTS header. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. "HSTS" stands for "HTTP Strict Transport Security". */
-  description: 'Deployment of the HSTS header significantly ' +
-    'reduces the risk of downgrading HTTP connections and eavesdropping attacks. ' +
-    'A rollout in stages, starting with a low max-age is recommended. ' +
-    '[Learn more about using a strong HSTS policy.](https://developer.chrome.com/docs/lighthouse/best-practices/has-hsts)',
-  /** Summary text for the results of a Lighthouse audit that evaluates the HSTS header. This is displayed if no HSTS header is deployed. "HSTS" stands for "HTTP Strict Transport Security". */
-  noHsts: 'No HSTS header found',
-  /** Summary text for the results of a Lighthouse audit that evaluates the HSTS header. This is displayed if the preload directive is missing. "HSTS" stands for "HTTP Strict Transport Security". */
-  noPreload: 'No `preload` directive found',
-  /** Summary text for the results of a Lighthouse audit that evaluates the HSTS header. This is displayed if the includeSubDomains directive is missing. "HSTS" stands for "HTTP Strict Transport Security". */
-  noSubdomain: 'No `includeSubDomains` directive found',
-  /** Summary text for the results of a Lighthouse audit that evaluates the HSTS header. This is displayed if the max-age directive is missing. "HSTS" stands for "HTTP Strict Transport Security". */
-  noMaxAge: 'No `max-age` directive',
-  /** Summary text for the results of a Lighthouse audit that evaluates the HSTS header. This is displayed if the provided duration for the max-age directive is too low. "HSTS" stands for "HTTP Strict Transport Security". */
-  lowMaxAge: '`max-age` is too low',
-  /** Table item value calling out the presence of a syntax error. */
-  invalidSyntax: 'Invalid syntax',
-  /** Label for a column in a data table; entries will be a directive of the HSTS header. "HSTS" stands for "HTTP Strict Transport Security". */
-  columnDirective: 'Directive',
-  /** Label for a column in a data table; entries will be the severity of an issue with the HSTS header. "HSTS" stands for "HTTP Strict Transport Security". */
-  columnSeverity: 'Severity',
-};
-
-const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
-
-class HasHsts extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'has-hsts',
-      scoreDisplayMode: Audit.SCORING_MODES.INFORMATIVE,
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-      requiredArtifacts: ['devtoolsLogs', 'URL'],
-      supportedModes: ['navigation'],
-    };
-  }
-
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<string[]>}
-   */
-  static async getRawHsts(artifacts, context) {
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    const mainResource =
-        await MainResource.request({devtoolsLog, URL: artifacts.URL}, context);
-
-    let hstsHeaders =
-        mainResource.responseHeaders
-            .filter(h => {
-              return h.name.toLowerCase() === 'strict-transport-security';
-            })
-            .flatMap(h => h.value.split(';'));
-
-    // Sanitize the header value / directives.
-    hstsHeaders = hstsHeaders.map(v => v.toLowerCase().replace(/\s/g, ''));
-
-    return hstsHeaders;
-  }
-
-  /**
-   * @param {string} hstsDirective
-   * @param {LH.IcuMessage | string} findingDescription
-   * @param {LH.IcuMessage=} severity
-   * @return {LH.Audit.Details.TableItem}
-   */
-  static findingToTableItem(hstsDirective, findingDescription, severity) {
-    return {
-      directive: hstsDirective,
-      description: findingDescription,
-      severity,
-    };
-  }
-
-  /**
-   * @param {string[]} hstsHeaders
-   * @return {{score: number, results: LH.Audit.Details.TableItem[]}}
-   */
-  static constructResults(hstsHeaders) {
-    const rawHsts = [...hstsHeaders];
-    const allowedDirectives = ['max-age', 'includesubdomains', 'preload'];
-    const violations = [];
-    const warnings = [];
-    const syntax = [];
-
-    if (!rawHsts.length) {
-      return {
-        score: 0,
-        results: [{
-          severity: str_(i18n.UIStrings.itemSeverityHigh),
-          description: str_(UIStrings.noHsts),
-          directive: undefined,
-        }],
-      };
-    }
-
-    // No max-age is a violation and renders the HSTS header useless.
-    if (!hstsHeaders.toString().includes('max-age')) {
-      violations.push({
-        severity: str_(i18n.UIStrings.itemSeverityHigh),
-        description: str_(UIStrings.noMaxAge),
-        directive: 'max-age',
-      });
-    }
-
-    if (!hstsHeaders.toString().includes('includesubdomains')) {
-      // No includeSubdomains might be even wanted. But would be preferred.
-      warnings.push({
-        severity: str_(i18n.UIStrings.itemSeverityMedium),
-        description: str_(UIStrings.noSubdomain),
-        directive: 'includeSubDomains',
-      });
-    }
-
-    if (!hstsHeaders.toString().includes('preload')) {
-      // No preload might be even wanted. But would be preferred.
-      warnings.push({
-        severity: str_(i18n.UIStrings.itemSeverityMedium),
-        description: str_(UIStrings.noPreload),
-        directive: 'preload',
-      });
-    }
-
-    for (const actualDirective of hstsHeaders) {
-      // We recommend 2y max-age. But if it's lower than 1y, it's a violation.
-      if (actualDirective.includes('max-age') &&
-          parseInt(actualDirective.split('=')[1], 10) < 31536000) {
-        violations.push({
-          severity: str_(i18n.UIStrings.itemSeverityHigh),
-          description: str_(UIStrings.lowMaxAge),
-          directive: 'max-age',
-        });
-      }
-
-      // If there is a directive that's not an official HSTS directive.
-      if (!allowedDirectives.includes(actualDirective) &&
-          !actualDirective.includes('max-age')) {
-        syntax.push({
-          severity: str_(i18n.UIStrings.itemSeverityLow),
-          description: str_(UIStrings.invalidSyntax),
-          directive: actualDirective,
-        });
-      }
-    }
-
-    const results = [
-      ...violations.map(
-          f => this.findingToTableItem(
-              f.directive, f.description,
-              str_(i18n.UIStrings.itemSeverityHigh))),
-      ...warnings.map(
-          f => this.findingToTableItem(
-              f.directive, f.description,
-              str_(i18n.UIStrings.itemSeverityMedium))),
-      ...syntax.map(
-          f => this.findingToTableItem(
-              f.directive, f.description,
-              str_(i18n.UIStrings.itemSeverityLow))),
-    ];
-    return {score: violations.length || syntax.length ? 0 : 1, results};
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const hstsHeaders = await this.getRawHsts(artifacts, context);
-    const {score, results} = this.constructResults(hstsHeaders);
-
-    /** @type {LH.Audit.Details.Table['headings']} */
-    const headings = [
-      /* eslint-disable max-len */
-      {key: 'description', valueType: 'text', subItemsHeading: {key: 'description'}, label: str_(i18n.UIStrings.columnDescription)},
-      {key: 'directive', valueType: 'code', subItemsHeading: {key: 'directive'}, label: str_(UIStrings.columnDirective)},
-      {key: 'severity', valueType: 'text', subItemsHeading: {key: 'severity'}, label: str_(UIStrings.columnSeverity)},
-      /* eslint-enable max-len */
-    ];
-    const details = Audit.makeTableDetails(headings, results);
-
-    return {
-      score,
-      notApplicable: !results.length,
-      details,
-    };
-  }
-}
-
-export default HasHsts;
-export {UIStrings};

package/core/audits/origin-isolation.d.ts

@@ -1,40 +0,0 @@
-export default OriginIsolation;
-declare class OriginIsolation extends Audit {
-    /**
-     * @param {LH.Artifacts} artifacts
-     * @param {LH.Audit.Context} context
-     * @return {Promise<string[]>}
-     */
-    static getRawCoop(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<string[]>;
-    /**
-     * @param {string | undefined} coopDirective
-     * @param {LH.IcuMessage | string} findingDescription
-     * @param {LH.IcuMessage=} severity
-     * @return {LH.Audit.Details.TableItem}
-     */
-    static findingToTableItem(coopDirective: string | undefined, findingDescription: LH.IcuMessage | string, severity?: LH.IcuMessage | undefined): LH.Audit.Details.TableItem;
-    /**
-     * @param {string[]} coopHeaders
-     * @return {{score: number, results: LH.Audit.Details.TableItem[]}}
-     */
-    static constructResults(coopHeaders: string[]): {
-        score: number;
-        results: LH.Audit.Details.TableItem[];
-    };
-    /**
-     * @param {LH.Artifacts} artifacts
-     * @param {LH.Audit.Context} context
-     * @return {Promise<LH.Audit.Product>}
-     */
-    static audit(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<LH.Audit.Product>;
-}
-export namespace UIStrings {
-    let title: string;
-    let description: string;
-    let noCoop: string;
-    let invalidSyntax: string;
-    let columnDirective: string;
-    let columnSeverity: string;
-}
-import { Audit } from './audit.js';
-//# sourceMappingURL=origin-isolation.d.ts.map

package/core/audits/origin-isolation.js

@@ -1,155 +0,0 @@
-/**
- * @license
- * Copyright 2024 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import {Audit} from './audit.js';
-import {MainResource} from '../computed/main-resource.js';
-import * as i18n from '../lib/i18n/i18n.js';
-
-const UIStrings = {
-  /** Title of a Lighthouse audit that evaluates the security of a page's COOP header for origin isolation. "COOP" stands for "Cross-Origin-Opener-Policy" and should not be translated. */
-  title: 'Ensure proper origin isolation with COOP',
-  /** Description of a Lighthouse audit that evaluates the security of a page's COOP header for origin isolation. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. "COOP" stands for "Cross-Origin-Opener-Policy", neither should be translated. */
-  description: 'The Cross-Origin-Opener-Policy (COOP) can be used to isolate the top-level window from other documents such as pop-ups. [Learn more about deploying the COOP header.](https://web.dev/articles/why-coop-coep#coop)',
-  /** Summary text for the results of a Lighthouse audit that evaluates the COOP header for origin isolation. This is displayed if no COOP header is deployed. "COOP" stands for "Cross-Origin-Opener-Policy" and should not be translated. */
-  noCoop: 'No COOP header found',
-  /** Table item value calling out the presence of a syntax error. */
-  invalidSyntax: 'Invalid syntax',
-  /** Label for a column in a data table; entries will be a directive of the COOP header. "COOP" stands for "Cross-Origin-Opener-Policy". */
-  columnDirective: 'Directive',
-  /** Label for a column in a data table; entries will be the severity of an issue with the COOP header. "COOP" stands for "Cross-Origin-Opener-Policy". */
-  columnSeverity: 'Severity',
-};
-
-const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
-
-class OriginIsolation extends Audit {
-  /**
-   * @return {LH.Audit.Meta}
-   */
-  static get meta() {
-    return {
-      id: 'origin-isolation',
-      scoreDisplayMode: Audit.SCORING_MODES.INFORMATIVE,
-      title: str_(UIStrings.title),
-      description: str_(UIStrings.description),
-      requiredArtifacts: ['devtoolsLogs', 'URL'],
-      supportedModes: ['navigation'],
-    };
-  }
-
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<string[]>}
-   */
-  static async getRawCoop(artifacts, context) {
-    const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    const mainResource =
-        await MainResource.request({devtoolsLog, URL: artifacts.URL}, context);
-
-    let coopHeaders =
-        mainResource.responseHeaders
-            .filter(h => {
-              return h.name.toLowerCase() === 'cross-origin-opener-policy';
-            })
-            .flatMap(h => h.value);
-
-    // Sanitize the header value.
-    coopHeaders = coopHeaders.map(v => v.toLowerCase().replace(/\s/g, ''));
-
-    return coopHeaders;
-  }
-
-  /**
-   * @param {string | undefined} coopDirective
-   * @param {LH.IcuMessage | string} findingDescription
-   * @param {LH.IcuMessage=} severity
-   * @return {LH.Audit.Details.TableItem}
-   */
-  static findingToTableItem(coopDirective, findingDescription, severity) {
-    return {
-      directive: coopDirective,
-      description: findingDescription,
-      severity,
-    };
-  }
-
-  /**
-   * @param {string[]} coopHeaders
-   * @return {{score: number, results: LH.Audit.Details.TableItem[]}}
-   */
-  static constructResults(coopHeaders) {
-    const rawCoop = [...coopHeaders];
-    const allowedDirectives = [
-      'unsafe-none', 'same-origin-allow-popups', 'same-origin',
-      'noopener-allow-popups',
-    ];
-    const violations = [];
-    const syntax = [];
-
-    if (!rawCoop.length) {
-      violations.push({
-        severity: str_(i18n.UIStrings.itemSeverityHigh),
-        description: str_(UIStrings.noCoop),
-        directive: undefined,
-      });
-    }
-
-    for (const actualDirective of coopHeaders) {
-      // If there is a directive that's not an official COOP directive.
-      if (!allowedDirectives.includes(actualDirective)) {
-        syntax.push({
-          severity: str_(i18n.UIStrings.itemSeverityLow),
-          description: str_(UIStrings.invalidSyntax),
-          directive: actualDirective,
-        });
-      }
-    }
-
-    const results = [
-      ...violations.map(
-          f => this.findingToTableItem(
-              f.directive, f.description,
-              str_(i18n.UIStrings.itemSeverityHigh))),
-      ...syntax.map(
-          f => this.findingToTableItem(
-              f.directive, f.description,
-              str_(i18n.UIStrings.itemSeverityLow))),
-    ];
-
-    return {score: violations.length || syntax.length ? 0 : 1, results};
-  }
-
-  /**
-   * @param {LH.Artifacts} artifacts
-   * @param {LH.Audit.Context} context
-   * @return {Promise<LH.Audit.Product>}
-   */
-  static async audit(artifacts, context) {
-    const coopHeaders = await this.getRawCoop(artifacts, context);
-    const {score, results} = this.constructResults(coopHeaders);
-
-    /** @type {LH.Audit.Details.Table['headings']} */
-    const headings = [
-      /* eslint-disable max-len */
-      {key: 'description', valueType: 'text', subItemsHeading: {key: 'description'}, label: str_(i18n.UIStrings.columnDescription)},
-      {key: 'directive', valueType: 'code', subItemsHeading: {key: 'directive'}, label: str_(UIStrings.columnDirective)},
-      {key: 'severity', valueType: 'text', subItemsHeading: {key: 'severity'}, label: str_(UIStrings.columnSeverity)},
-      /* eslint-enable max-len */
-    ];
-    const details = Audit.makeTableDetails(headings, results);
-
-    return {
-      score,
-      notApplicable: !results.length,
-      details,
-    };
-  }
-}
-
-export default OriginIsolation;
-export {UIStrings};