performance api 可用于性能回归测试，需聚焦关键指标（如lcp、fcp、自定义mark/measure）、在可控时机采集并上报数据，再与历史基线结构化比对，最终嵌入ci闭环验证。
Performance API 是浏览器原生提供的高精度性能测量工具，它不依赖外部工具或模拟环境，能直接在真实用户场景中捕获关键时序数据。要把它用于性能回归测试，核心不是“单次测量”，而是建立可比、可追踪、可断言的指标采集与比对机制。
明确要监控的关键指标
不是所有 Performance API 数据都适合回归测试。应聚焦稳定、语义清晰、业务强相关的指标：
-
页面加载类：用
performance.getEntriesByType('navigation')提取domContentLoadedEventEnd、loadEventEnd、first-contentful-paint、largest-contentful-paint -
渲染与交互类：监听
paint和longtask类型条目，识别卡顿和长任务 -
自定义业务耗时：用
performance.mark()打点关键路径（如“搜索开始”“结果渲染完成”），再用performance.measure()计算区间耗时
在可控时机统一采集数据
避免因采集时机随机导致数据抖动。推荐在页面初始化完成、首屏渲染稳定后触发一次集中上报：
- 监听
DOMContentLoaded或load事件后延迟 100–300ms，确保 paint 条目已生成 - 调用
performance.getEntries()或按类型筛选，过滤出本次会话有效条目 - 附带上下文信息：当前 commit hash、环境标识（staging/prod）、设备类型（mobile/desktop）、网络类型（4g/3g）
- 使用
navigator.sendBeacon()上报，保障页面卸载前也能发出数据
与版本基线做结构化比对
回归测试的价值在于“对比”。仅采集无意义，需将本次数据与历史基准联动分析：
- 将每次构建的 Performance 数据按 commit 分组，存入轻量时序数据库（如 InfluxDB）或 JSON 文件归档
- 设定统计口径：例如取 P90 的 LCP 值作为该版本代表值，而非平均值（避免异常值干扰）
- 在 CI 流程中运行比对脚本：若当前版本 P90 LCP 比上一版升高超过 15% 且绝对值 > 2800ms，则标记为疑似回归
- 支持多维下钻：比如发现移动端 LCP 显著退化，但桌面端正常，说明问题可能与响应式逻辑或媒体查询相关
嵌入 CI 环节形成闭环反馈
把 Performance API 数据变成 CI 的“第一手证据”，而不是事后补救依据：
- 在 GitLab CI 或 GitHub Actions 中，添加一个 Puppeteer 或 Playwright 脚本：启动浏览器 → 访问目标 URL → 等待加载完成 → 注入采集逻辑 → 导出 JSON 结果
- 该脚本输出应包含结构化字段：
{"lcp_p90": 2650, "cls_p75": 0.12, "custom_search_duration_p90": 1840} - 用简单 Node.js 脚本读取前后两次 JSON，执行阈值判断；失败时输出具体指标变化和链接到历史报告
- 结合 Lighthouse CI 报告交叉验证：若 Lighthouse 合成 LCP 升高 + 真实用户样本 P95 LCP 同步升高，可信度更高
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
