PerformanceResourceTiming：serverTiming 属性

基线 2023

新发布

自 2023 年 3 月起，此功能在最新的设备和浏览器版本中有效。此功能可能在旧设备或浏览器中不起作用。

安全上下文： 此功能仅在 安全上下文 (HTTPS) 中可用，在一些或所有 支持浏览器 中可用。

serverTiming 只读属性返回一个包含服务器计时指标的 PerformanceServerTiming 条目数组。

服务器计时指标要求服务器发送 Server-Timing 标头。例如

http
Server-Timing: cache;desc="Cache Read";dur=23.2

serverTiming 条目可以存在于 navigation 和 resource 条目中。

值

一个 PerformanceServerTiming 条目数组。

示例

记录服务器计时条目

可以使用 PerformanceObserver 来监控 PerformanceServerTiming 条目。每个服务器条目的持续时间都会记录到控制台中。

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

js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    entry.serverTiming.forEach((serverEntry) => {
      console.log(`${serverEntry.name} duration: ${serverEntry.duration}`);
    });
  });
});

["navigation", "resource"].forEach((type) =>
  observer.observe({ type, buffered: true }),
);

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

js
for (const entryType of ["navigation", "resource"]) {
  for (const { name: url, serverTiming } of performance.getEntriesByType(
    entryType,
  )) {
    if (serverTiming) {
      for (const { name, duration } of serverTiming) {
        console.log(`${url}: ${name} duration: ${duration}`);
      }
    }
  }
}

跨域服务器计时信息

访问服务器计时信息受限于同一来源。要公开跨域计时信息，需要设置 Timing-Allow-Origin HTTP 响应标头。

例如，要允许 https://mdn.org.cn 查看服务器计时信息，跨域资源应发送

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

规范

规范
服务器计时
# servertiming-attribute

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅