PerformanceNavigationTiming - Web API 接口参考 编辑

这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

PerformanceNavigationTiming 提供了用于存储和检索有关浏览器文档事件的指标的方法和属性。 例如，此接口可用于确定加载或卸载文档需要多少时间。

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/wiki/zh-CN/docs/Web/API/PerformanceEntry" target="_top"><rect x="1" y="1" width="160" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="81" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">PerformanceEntry</text></a><polyline points="161,25  171,20  171,30  161,25" stroke="#D4DDE4" fill="none"/><line x1="171" y1="25" x2="201" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/wiki/zh-CN/docs/Web/API/PerformanceNavigationTiming" target="_top"><rect x="201" y="1" width="270" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="336" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">PerformanceNavigationTiming</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

属性

该接口扩展了 PerformanceEntry 属性，修订和约束以下性能条目：

PerformanceEntry.entryType 只读

返回 "navigation".

PerformanceEntry.name 只读

返回 文档地址.

PerformanceEntry.startTime 只读

返回值为0的 DOMHighResTimeStamp。

PerformanceEntry.duration 只读

返回 timestamp 值，即 PerformanceNavigationTiming.loadEventEnd 和 PerformanceEntry.startTime 属性之间的差值。

该接口还扩展 PerformanceResourceTiming 属性，修订和约束以下性能条目：

PerformanceResourceTiming.initiatorType只读

返回 "navigation".

该接口还支持以下属性：

PerformanceNavigationTiming.domComplete 只读  

一个 DOMHighResTimeStamp 时间值，等于浏览器将当前文档的当前文档准备就绪之前的时间。

PerformanceNavigationTiming.domContentLoadedEventEnd 只读

一个 DOMHighResTimeStamp 时间值，等于当前文档的 DOMContentLoaded 事件完成后的时间。

PerformanceNavigationTiming.domContentLoadedEventStart 只读

一个 DOMHighResTimeStamp 时间值，等于用户代理在当前文档上触发 DOMContentLoaded 事件之前的时间。

PerformanceNavigationTiming.domInteractive 只读  

一个 DOMHighResTimeStamp 时间值，等于用户代理将当前文档的当前文档准备就绪设置为交互之前的时间。

PerformanceNavigationTiming.loadEventEnd 只读  

一个 DOMHighResTimeStamp 时间值，代表当前文档的加载事件完成的时间。

PerformanceNavigationTiming.loadEventStart 只读  

一个 DOMHighResTimeStamp 时间值，等于立即触发当前文档的加载事件之前的时间。

PerformanceNavigationTiming.redirectCount 只读  

表示自当前浏览上下文中上次非重定向导航以来的重定向次数的数字。

如果没有重定向，或者重定向是从另一个 origin 发的，并且该 origin 不允许将其计时信息公开给当前来源，则该值为0。

PerformanceNavigationTiming.requestStart 只读  

返回一个 DOMHighResTimeStamp 时间值，代表 UA 立即开始从服务器，相关应用程序缓存或本地资源请求资源之前的时间。

PerformanceNavigationTiming.responseStart 只读  

一个 DOMHighResTimeStamp 时间值，代表用户代理的HTTP解析器从相关应用程序缓存，本地资源或服务器接收到响应的第一个字节后立即的时间。

PerformanceNavigationTiming.type 只读  

一个 string 表示导航类型，取值为为：“navigate”，“reload”，“back_forward”或“prerender”。

PerformanceNavigationTiming.unloadEventEnd 只读  

一个 DOMHighResTimeStamp 时间值，等于用户代理程序完成前一文档的卸载事件之后的时间。

PerformanceNavigationTiming.unloadEventStart 只读  

一个 DOMHighResTimeStamp 时间值，等于用户代理程序开始前一个文档的卸载事件之前的时间。

方法

PerformanceNavigationTiming.toJSON()

返回一个表示PerformanceNavigationTiming对象的DOMString JSON。

规范

规范	状态	注释
Navigation Timing Level 2 PerformanceNavigationTiming	Working Draft	Initial definition.

浏览器兼容性

BCD tables only load in the browser

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

参见

• Performance.navigation
• PerformanceNavigation