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 指标。