PerformanceServerTiming：description 属性

基线 2023

新可用

自 2023 年 3 月起，此功能可在最新的设备和浏览器版本上运行。此功能可能在较旧的设备或浏览器上无法运行。

description 只读属性返回服务器指定的指标描述的字符串值，或者返回空字符串。

值

字符串。

示例

记录服务器计时条目

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

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

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

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

js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    entry.serverTiming.forEach((serverEntry) => {
      console.log(
        `${serverEntry.name} (${serverEntry.description}) duration: ${serverEntry.duration}`,
      );
      // Logs "cache (Cache Read) duration: 23.2"
    });
  });
});

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

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

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

规范

规范
服务器计时
# dom-performanceservertiming-description

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅