PerformanceEntry: duration-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte Eigenschaft duration gibt einen Zeitstempel zurück, der die Dauer des Performance-Eintrags angibt. Die Bedeutung dieser Eigenschaft hängt vom Wert der entryType-Eigenschaft des Eintrags ab.
Wert
Ein DOMHighResTimeStamp, der die Dauer des Performance-Eintrags angibt. Wenn das Konzept einer Dauer auf eine bestimmte Performance-Metrik nicht anwendbar ist, wird 0 zurückgegeben.
Die Bedeutung dieser Eigenschaft hängt vom Wert der entryType-Eigenschaft des Performance-Eintrags ab:
event-
Die Zeit vom
startTimedes Ereignisses bis zum nächsten Rendering-Paint (auf die nächsten 8 ms gerundet). first-input-
Die Zeit vom
startTimedes ersten Eingabeereignisses bis zum nächsten Rendering-Paint (auf die nächsten 8 ms gerundet). longtask-
Die verstrichene Zeit zwischen Beginn und Ende der Aufgabe, mit einer Auflösung von 1 ms.
measure-
Die Dauer der Messung.
-
Die Differenz zwischen den Eigenschaften
loadEventEndundstartTimedes Eintrags. resource-
Der Wert von
responseEnddes Eintrags abzüglich des Werts vonstartTimedes Eintrags.
Für die folgenden Eintragstypen ist duration nicht anwendbar; der Wert ist in diesen Fällen immer 0:
containerelementlargest-contentful-paintlayout-shiftmarkpainttaskattributionvisibility-state
Beispiele
>Die duration-Eigenschaft verwenden
Das folgende Beispiel protokolliert alle beobachteten Performance-Einträge mit einer duration größer als 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"] });
Spezifikationen
| Spezifikation |
|---|
| Performance Timeline> # dom-performanceentry-duration> |