PerformanceServerTiming：toJSON() 方法

基线 2023

新近可用

自 2023 年 3 月起，此功能在最新的设备和浏览器版本上都能正常工作。此功能可能无法在较旧的设备或浏览器中正常工作。

toJSON() 方法是 PerformanceServerTiming 接口的一个 序列化器；它返回 PerformanceServerTiming 对象的 JSON 表示形式。

语法

js
toJSON()

参数

无。

返回值

一个 JSON 对象，它是 PerformanceServerTiming 对象的序列化结果。

示例

记录服务器计时条目

服务器计时指标要求服务器发送 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.toJSON());
    });
  });
});

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

这将记录一个类似这样的 JSON 对象

json
{
  "name": "cache",
  "duration": 23.2,
  "description": "Cache Read"
}

要获得一个 JSON 字符串，您可以直接使用 JSON.stringify(serverEntry)；它会自动调用 toJSON()。

规范

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

浏览器兼容性

BCD 表格只能在浏览器中加载