NNext.js 中文网 GitHub

webVitalsAttribution

了解如何使用 webVitalsAttribution 选项来精确定位 Web Vitals 问题的来源。

在调试与 Web Vitals 相关的问题时,如果我们能够精确定位问题的根源,通常会很有帮助。 例如,对于累积布局偏移(Cumulative Layout Shift,CLS),我们可能想知道在最大的一次布局偏移发生时首个发生偏移的元素。 或者,对于最大内容绘制(Largest Contentful Paint,LCP),我们可能想确定与该页面的 LCP 对应的元素。 如果 LCP 元素是图片,知道图片资源的 URL 可以帮助我们定位需要优化的资产。

精确定位对 Web Vitals 分数影响最大的因素,即归因(attribution),使我们能够获得更深入的信息,例如 PerformanceEventTiming、PerformanceNavigationTiming 和 PerformanceResourceTiming 的条目。

Next.js 中默认禁用归因,但可以通过在 next.config.js 中指定以下内容来按指标启用。

next.config.js
module.exports = {
  experimental: {
    webVitalsAttribution: ['CLS', 'LCP'],
  },
}

有效的归因值是 NextWebVitalsMetric 类型中指定的所有 web-vitals 指标。