PerformanceResourceTiming: workerStart 属性

Baseline 已广泛支持

此功能已非常成熟,可在许多设备和浏览器版本上运行。自 2018 年 1 月起,它已在所有浏览器中可用。

注意:此功能在 Web Workers 中可用。

workerStartPerformanceResourceTiming 接口的一个只读属性,它返回一个 DOMHighResTimeStamp。该时间戳表示在 Service Worker 线程已运行时,在分派 FetchEvent 之前立即;或者在 Service Worker 线程尚未运行时,在启动 Service Worker 线程之前立即。如果资源未被 Service Worker 拦截,则该属性始终返回 0。

workerStart 属性可能具有以下值:

示例

测量 ServiceWorker 处理时间

workerStartfetchStart 属性可用于测量 ServiceWorker 的处理时间。

js
const workerProcessingTime = entry.fetchStart - entry.workerStart;

使用 PerformanceObserver 的示例,它会在浏览器性能时间线中记录新的 resource 性能条目时通知。使用 buffered 选项可以访问观察者创建之前的条目。

js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    const workerProcessingTime = entry.fetchStart - entry.workerStart;
    if (workerProcessingTime > 0) {
      console.log(
        `${entry.name}: Worker processing time: ${workerProcessingTime}ms`,
      );
    }
  });
});

observer.observe({ type: "resource", buffered: true });

使用 Performance.getEntriesByType() 的示例,它只显示在调用此方法时浏览器性能时间线中存在的 resource 性能条目

js
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  const workerProcessingTime = entry.fetchStart - entry.workerStart;
  if (workerProcessingTime > 0) {
    console.log(
      `${entry.name}: Worker processing time: ${workerProcessingTime}ms`,
    );
  }
});

跨域计时信息

如果 workerStart 属性的值为 0,则该资源可能是跨域请求。为了能够看到跨域时序信息,需要设置 Timing-Allow-Origin HTTP 响应头。

例如,要允许 https://mdn.org.cn 查看时序资源,跨域资源应发送

http
Timing-Allow-Origin: https://mdn.org.cn

规范

规范
资源时序
# dom-performanceresourcetiming-workerstart

浏览器兼容性

另见