跳到内容
配置next.config.jswebVitalsAttribution

webVitalsAttribution

此功能目前为实验性功能,可能会发生变化,不建议用于生产环境。欢迎试用并在 GitHub 上分享您的反馈。

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

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

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

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

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