Performance API
The read-only duration property returns a DOMHighResTimeStamp that is the duration of the PerformanceEntry. The meaning of this property depends on the value of this entry's PerformanceEntry.entryType.
Value
A DOMHighResTimeStamp representing the duration of the PerformanceEntry. If the duration concept doesn't apply for a particular performance metric, a duration of 0 is returned.
The meaning of this property depends on the value of this performance entry's PerformanceEntry.entryType:
event- : The time from the event's
startTimeto the next rendering paint (rounded to the nearest 8ms).
- : The time from the event's
first-input- : The time from the first input event's
startTimeto the next rendering paint (rounded to the nearest 8ms).
- : The time from the first input event's
longtask- : The elapsed time between the start and end of task, with a 1ms granularity.
measure- : The duration of the measure.
navigation- : The difference between the entry's PerformanceNavigationTiming.loadEventEnd and PerformanceEntry.startTime properties.
resource- : The entry's PerformanceResourceTiming/responseEnd value minus the entry's PerformanceEntry.startTime value.
For the following entry types, duration is not applicable, and in this case the value is always 0:
containerelementlargest-contentful-paintlayout-shiftmarkpainttaskattributionvisibility-state
Examples
Using the duration property
The following example logs all observed performance entries with a duration larger than 0.
function perfObserver(list, observer) {
list.getEntries().forEach((entry) => {
if (entry.duration > 0) {
console.log(`${entry.name}'s duration: ${entry.duration}`);
}
});
}
const observer = new PerformanceObserver(perfObserver);
observer.observe({ entryTypes: ["measure", "mark", "resource"] });
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
