PerformanceEntry: duration-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte duration
-Eigenschaft gibt einen Zeitstempel zurück, der die Dauer des Performance Entry darstellt. Die Bedeutung dieser Eigenschaft hängt vom Wert des entryType
dieses Eintrags ab.
Wert
Ein DOMHighResTimeStamp
, der die Dauer des Performance Entry darstellt. Wenn das Dauer-Konzept für eine bestimmte Leistungsmetrik nicht zutrifft, wird eine Dauer von 0
zurückgegeben.
Die Bedeutung dieser Eigenschaft hängt vom Wert des entryType
dieses Performance-Eintrags ab:
event
-
Die Zeit von
startTime
des Events bis zum nächsten Rendering-Paint (gerundet auf die nächsten 8ms). first-input
-
Die Zeit vom
startTime
des ersten Eingabegeräts bis zum nächsten Rendering-Paint (gerundet auf die nächsten 8ms). longtask
-
Die verstrichene Zeit zwischen Beginn und Ende der Aufgabe, mit einer Granularität von 1ms.
measure
-
Die Dauer der Messung.
-
Die Differenz zwischen den Eigenschaften
loadEventEnd
undstartTime
des Eintrags. resource
-
Der Wert von
responseEnd
des Eintrags minus dem Wert vonstartTime
des Eintrags.
Für die folgenden Eintragstypen ist duration
nicht zutreffend, und in diesem Fall ist der Wert immer 0
:
element
largest-contentful-paint
layout-shift
mark
paint
taskattribution
visibility-state
Beispiele
Verwendung der duration-Eigenschaft
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
Specification |
---|
Performance Timeline # dom-performanceentry-duration |
Browser-Kompatibilität
BCD tables only load in the browser