PerformanceResourceTiming: domainLookupStart 属性

Baseline 已广泛支持

此功能已成熟，可跨多种设备和浏览器版本使用。自 2017 年 9 月以来，它已在浏览器中提供。

注意：此功能在 Web Workers 中可用。

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`);
  }
});