PerformanceResourceTiming:domainLookupEnd 属性

基线 广泛可用

此功能已得到良好建立,并且可在许多设备和浏览器版本上运行。它自以下时间起在浏览器中可用 2017 年 9 月.

domainLookupEnd 只读属性返回浏览器完成资源域名查找后立即的timestamp

如果用户代理在缓存中拥有域名信息,则domainLookupStartdomainLookupEnd 表示用户代理开始和结束从缓存中检索域名数据的时间。

domainLookupEnd 属性可以具有以下值

  • 一个DOMHighResTimeStamp,表示浏览器完成资源域名查找后立即的时间。
  • 如果资源是从缓存中即时检索到的,则为 0
  • 如果资源是跨域请求且未使用 Timing-Allow-Origin HTTP 响应标头,则为 0

示例

测量 DNS 查找时间

domainLookupEnddomainLookupStart 属性可用于测量 DNS 查找需要多长时间。

js
const dns = entry.domainLookupEnd - entry.domainLookupStart;

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

js
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 性能条目

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

跨域计时信息

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

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

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

规范

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

浏览器兼容性

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

另请参阅