PerformanceResourceTiming: secureConnectionStart 属性
secureConnectionStart
只读属性返回一个 时间戳
,该时间戳紧接在浏览器开始握手过程以保护当前连接之前。如果未使用安全连接,则该属性返回零。
值
secureConnectionStart
属性可以具有以下值
- 如果资源通过安全连接获取,则为
DOMHighResTimeStamp
,指示浏览器开始握手过程以保护当前连接之前的时刻。 - 如果未使用安全连接,则为
0
。 - 如果资源是从缓存中即时检索的,则为
0
。 - 如果资源是跨源请求且未使用
Timing-Allow-Origin
HTTP 响应头,则为0
。
示例
测量 TLS 协商时间
secureConnectionStart
和 requestStart
属性可用于测量 TLS 协商需要多长时间。
js
const tls = entry.requestStart - entry.secureConnectionStart;
使用 PerformanceObserver
的示例,它在浏览器性能时间轴中记录新的 resource
性能条目时通知。使用 buffered
选项访问观察器创建之前的条目。
js
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
const tls = entry.requestStart - entry.secureConnectionStart;
if (tls > 0) {
console.log(`${entry.name}: TLS negotiation duration: ${tls}ms`);
}
});
});
observer.observe({ type: "resource", buffered: true });
使用 Performance.getEntriesByType()
的示例,它仅显示在调用此方法时浏览器性能时间轴中存在的 resource
性能条目
js
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
const tls = entry.requestStart - entry.secureConnectionStart;
if (tls > 0) {
console.log(`${entry.name}: TLS negotiation duration: ${tls}ms`);
}
});
跨源计时信息
如果 secureConnectionStart
属性的值为 0
,则资源要么未使用安全连接,要么是跨源请求。要允许查看跨源计时信息,需要设置 Timing-Allow-Origin
HTTP 响应头。
例如,要允许 https://mdn.org.cn
查看计时资源,跨源资源应发送
http
Timing-Allow-Origin: https://mdn.org.cn
规范
规范 |
---|
资源计时 # dom-performanceresourcetiming-secureconnectionstart |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。