PerformanceResourceTiming: firstInterimResponseStart 属性

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

firstInterimResponseStart 只读属性在浏览器从服务器接收中间 1xx 响应(例如,100 Continue 或 103 Early Hints)的第一字节后立即返回一个 时间戳

firstInterimResponseStart 没有结束属性。

firstInterimResponseStart 属性可以具有以下值

  • 在浏览器从服务器接收到响应的第一个中间字节后立即返回一个 DOMHighResTimeStamp
  • 如果资源未发送任何中间响应,则为0
  • 如果资源是跨源请求且未使用 Timing-Allow-Origin HTTP 响应头,则为0

注意:由于早期提示通常仅在主导航请求(根据定义是同源的)上受支持,因此0 通常表示未使用早期提示。

示例

测量请求时间

firstInterimResponseStartrequestStart 属性可用于测量浏览器在发送请求后接收中间响应所需的时间。

js
const request = entry.firstInterimResponseStart - entry.requestStart;

以下示例使用 PerformanceObserver 在浏览器性能时间线上记录新的resource 性能条目时发出通知。buffered 选项用于访问观察器创建之前的条目。

js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    const request = entry.firstInterimResponseStart - entry.requestStart;
    if (request > 0) {
      console.log(`${entry.name}: Interim response time: ${request}ms`);
    }
  });
});

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

以下示例使用 Performance.getEntriesByType(),它仅显示浏览器性能时间线上在您调用该方法时存在的resource 性能条目。

js
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  const request = entry.firstInterimResponseStart - entry.requestStart;
  if (request > 0) {
    console.log(`${entry.name}: Interim response time: ${request}ms`);
  }
});

跨源计时信息

如果firstInterimResponseStart 属性的值为0,则资源可能是跨源请求。要允许查看跨源计时信息,需要设置 Timing-Allow-Origin HTTP 响应头。

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

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

规范

规范
资源计时
# dom-performanceresourcetiming-firstinterimresponsestart

浏览器兼容性

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

另请参阅