This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.
The PerformanceNavigationTiming interface provides methods and properties to store and retrieve metrics regarding the browser's document navigation events. For example, this interface can be used to determine how much time it takes to load or unload a document.
<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/en-US/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/en-US/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;}Properties
This interface extends the following PerformanceEntry properties for navigation performance entry types by qualifying and constraining them as follows:
PerformanceEntry.entryTypeRead only- Returns
"navigation". PerformanceEntry.nameRead only- Returns the document's address.
PerformanceEntry.startTimeRead only- Returns a
DOMHighResTimeStampwith a value of "0". PerformanceEntry.durationRead only- Returns a
timestampthat is the difference between thePerformanceNavigationTiming.loadEventEndandPerformanceEntry.startTimeproperties.
This interface also extends following PerformanceResourceTiming properties for navigation performance entry types by qualifying and constraining them as follows:
PerformanceResourceTiming.initiatorTypeRead only- Returns
"navigation".
The interface also supports the following properties:
PerformanceNavigationTiming.domCompleteRead only- A
DOMHighResTimeStamprepresenting a time value equal to the time immediately before the browser sets the current document readiness of the current document to complete. PerformanceNavigationTiming.domContentLoadedEventEndRead only- A
DOMHighResTimeStamprepresenting the time value equal to the time immediately after the current document's DOMContentLoaded event completes. PerformanceNavigationTiming.domContentLoadedEventStartRead only- A
DOMHighResTimeStamprepresenting the time value equal to the time immediately before the user agent fires the DOMContentLoaded event at the current document. PerformanceNavigationTiming.domInteractiveRead only- A
DOMHighResTimeStamprepresenting atimestamprepresenting the time value equal to the time immediately before the user agent sets the current document readiness of the current document to interactive. PerformanceNavigationTiming.loadEventEndRead only- A
DOMHighResTimeStamprepresenting the time when the load event of the current document is completed. PerformanceNavigationTiming.loadEventStartRead only- A
DOMHighResTimeStamprepresenting the time value equal to the time immediately before the load event of the current document is fired. PerformanceNavigationTiming.redirectCountRead only- A number representing the number of redirects since the last non-redirect navigation under the current browsing context.
- If there was no redirect, or if the redirect was from another origin, and that origin does not permit it's timing information to be exposed to the current origin then the value will be 0.
PerformanceNavigationTiming.requestStartRead only- A
DOMHighResTimeStamprepresenting the time immediately before the user agent starts requesting the resource from the server, or from relevant application caches or from local resources. PerformanceNavigationTiming.responseStartRead only- A
DOMHighResTimeStamprepresenting the time immediately after the user agent's HTTP parser receives the first byte of the response from relevant application caches, or from local resources or from the server. PerformanceNavigationTiming.typeRead only- A
stringrepresenting the navigation type. Must be: "navigate", "reload", "back_forward" or "prerender". PerformanceNavigationTiming.unloadEventEndRead only- A
DOMHighResTimeStamprepresenting the time value equal to the time immediately after the user agent finishes the unload event of the previous document. PerformanceNavigationTiming.unloadEventStartRead only- A
DOMHighResTimeStamprepresenting the time value equal to the time immediately before the user agent starts the unload event of the previous document.
Methods
PerformanceNavigationTiming.toJSON()- Returns a
DOMStringthat is the JSON representation of thePerformanceNavigationTimingobject.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Navigation Timing Level 2The definition of 'PerformanceNavigationTiming' in that specification. | Working Draft | Initial definition. |
Browser compatibility
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.
See also
PerformanceNavigationTiming by Mozilla Contributors is licensed under CC-BY-SA 2.5.
