PerformanceResourceTiming: domainLookupStart 属性

基线广泛可用

此功能已发展成熟，可在许多设备和浏览器版本中使用。它自以下日期起在浏览器中可用： 2017 年 9 月.

domainLookupStart 只读属性返回浏览器开始对资源进行域名查找之前的timestamp。

值

domainLookupStart 属性可以具有以下值

浏览器开始对资源进行域名查找之前的DOMHighResTimeStamp。
如果资源是从缓存中即时检索的，则为0。
如果资源是跨源请求且未使用Timing-Allow-Origin HTTP 响应头，则为0。

示例

测量 DNS 查找时间

domainLookupStart 和domainLookupEnd 属性可用于测量 DNS 查找所需的时间。

const dns = entry.domainLookupEnd - entry.domainLookupStart;

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

const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    const dns = entry.domainLookupEnd - entry.domainLookupStart;
    if (dns > 0) {
      console.log(`${entry.name}: DNS lookup duration: ${dns}ms`);
    }
  });
});

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

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

const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  const dns = entry.domainLookupEnd - entry.domainLookupStart;
  if (dns > 0) {
    console.log(`${entry.name}: DNS lookup duration: ${dns}ms`);
  }
});

跨源计时信息

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

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

http

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

规范

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

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅

Timing-Allow-Origin