PerformanceResourceTiming:domainLookupEnd 属性
domainLookupEnd
只读属性返回浏览器完成资源域名查找后立即的timestamp
。
如果用户代理在缓存中拥有域名信息,则domainLookupStart
和 domainLookupEnd
表示用户代理开始和结束从缓存中检索域名数据的时间。
值
domainLookupEnd
属性可以具有以下值
- 一个
DOMHighResTimeStamp
,表示浏览器完成资源域名查找后立即的时间。 - 如果资源是从缓存中即时检索到的,则为
0
。 - 如果资源是跨域请求且未使用
Timing-Allow-Origin
HTTP 响应标头,则为0
。
示例
测量 DNS 查找时间
domainLookupEnd
和 domainLookupStart
属性可用于测量 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 的浏览器中加载。