实现 javascript 运行时性能指标采集 sdk 的核心做法是:利用浏览器提供的 performance api(如 performance.getentriesbytype)和 observer api(如 performanceobserver)主动或被动地收集数据,并通过 navigator.sendbeacon 将采集到的 json 对象异步发送至后端服务器。具体实施时,需定义一个配置项来筛选需要监控的指标类型(如 paint, resource, nav),初始化观察者实例并注册回调函数,在回调中处理数据格式转换,最后确保在页面卸载前可靠地发送数据。

如何初始化并注册 PerformanceObserver 以捕获长任务?
要捕获长任务(Long Tasks),必须使用 PerformanceObserver 监听 longtask 类型的性能条目。初始化时需创建一个实例,传入一个回调函数,该函数会在检测到长任务时接收一个包含 entries 数组的对象。在回调内部,遍历 entries 提取关键信息如 duration、name 和 startTime,并将它们存入本地队列。需要注意的是,PerformanceObserver 支持 buffered: true 选项,可以获取观察器创建之前已经发生的长任务记录,这对于覆盖页面加载初期的性能问题至关重要。

const observer = new PerformanceObserver((list) => {
const entries = list.getEntries();
entries.forEach(entry => {
console.log(`Long Task Duration: ${entry.duration}ms`);
// 将 entry 数据推入采集队列
collectData({
type: 'longtask',
duration: entry.duration,
startTime: entry.startTime,
name: entry.name
});
});
});
// 观察 longtask 类型,并获取缓冲区的历史数据
observer.observe({ type: 'longtask', buffered: true });
如何利用 sendBeacon 确保数据在页面卸载时成功上报?
在用户关闭标签页或导航离开当前页面时,传统的 XMLHttpRequest 或 fetch 可能会因为请求被取消而导致数据丢失。navigator.sendBeacon 方法专为这种场景设计,它会将数据异步发送给服务器,且不会延迟页面的卸载过程。实现时,应监听 beforeunload 或 visibilitychange 事件,当检测到页面即将不可见时,检查采集队列中是否有未发送的数据。如果有,构造一个 Blob 对象或字符串,调用 sendBeacon 将其发送至指定的端点。该方法返回布尔值,指示数据是否成功加入发送队列,开发者可根据返回值进行简单的重试逻辑或日志记录。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;

window.addEventListener('beforeunload', () => {
if (queue.length > 0) {
const payload = JSON.stringify(queue);
navigator.sendBeacon('/api/performance', payload);
queue = []; // 清空队列
}
});
如何处理采集到的性能数据以确保其符合上报格式?
原始的性能条目对象结构复杂且包含大量浏览器内部字段,直接上报会增加带宽负担且不利于后端解析。因此,需要在采集阶段对数据进行清洗和标准化。例如,对于资源加载性能,只需保留 name(资源 URL)、duration(加载耗时)、initiatorType(发起类型)等关键字段。对于布局偏移(CLS),需要计算累积偏移量而非单次偏移。处理过程中,应将时间戳统一转换为相对于页面加载开始的时间(即 performance.now() 的值),并确保所有数值类型正确。最终生成的对象应符合预定义的 Schema,以便后端能够准确聚合和分析。


















