performanceobserver 必须在页面加载极早期同步注册于 内,不可延迟;fcp 和 lcp 需分 observer 监听,lcp 仅信任 starttime,上报需防重复且避免阻塞,safari 不支持 buffered: true。

要真正捕获到首屏关键性能数据,PerformanceObserver 必须在页面加载极早期注册,不能等 DOM 就绪或资源加载完成后再初始化。
必须在 中同步执行注册
FCP、LCP 这类指标可能在 HTML 解析中途就已触发。如果 observer 在 DOMContentLoaded 或 window.onload 里创建,大概率收不到任何有效 entry。
- 把初始化代码直接写在
<script>...</script>内,不加defer或async - 避免封装成函数再调用——observer 实例和
observe()调用都得立即执行 - 不要依赖第三方 SDK 的“初始化完成”钩子,它一定晚于首屏渲染
按类型分开监听,别混用
paint 和 largest-contentful-paint 是两类结构不同、触发逻辑独立的 entry,共用一个 observer 容易漏值或误判。
- FCP/FP 用
entryTypes: ['paint']监听,再通过entry.name === 'first-contentful-paint'过滤 - LCP 必须单独用
entryTypes: ['largest-contentful-paint']监听,取list.getEntries().pop()获取最终稳定值 - CLS 需监听
layout-shift,并过滤entry.hadRecentInput === false的条目
只信任 startTime,别碰 renderTime 和 size
LCP 的核心判断依据只有 entry.startTime,它是相对 navigationStart 的毫秒时间戳,代表内容真实渲染到屏幕的时刻。
-
entry.renderTime已废弃,旧版 Chrome 存在兼容问题,一律忽略 -
entry.size是像素面积,受设备 DPR 影响极大,不能用于卡顿判断或阈值比较 -
entry.element可能为null(如跨域图片未设crossorigin),使用前必须做存在性检查
防重复、防阻塞、保兼容
LCP 可能因动态内容插入而多次回调,但上报只需一次最终值;同时回调中执行重操作会拖慢 TTI。
- 用布尔变量标记是否已上报,首次触发后置为
true,后续忽略 - 避免在回调里调用
fetch、遍历节点或改样式,轻量上报可包一层queueMicrotask -
buffered: true对 LCP 在 Chromium 中有效,但 Safari 当前不支持,需准备 fallback 方案(如降级用performance.getEntriesByName检查)










