跳到内容
配置next.config.js 选项webVitalsAttribution

webVitalsAttribution

当调试与 Web Vitals 相关的问题时,如果我们能够查明问题的根源,通常会很有帮助。例如,在累积布局偏移 (CLS) 的情况下,我们可能想知道在发生单次最大布局偏移时,第一个偏移的元素是什么。或者,在最大内容ful Paint (LCP) 的情况下,我们可能想识别与页面 LCP 相对应的元素。如果 LCP 元素是图像,了解图像资源的 URL 可以帮助我们找到需要优化的资源。

查明 Web Vitals 分数的最大贡献者,也称为 归因,使我们能够获得更深入的信息,例如 PerformanceEventTimingPerformanceNavigationTimingPerformanceResourceTiming 的条目。

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

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

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