Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 startTime des Ereignisses bis zum nächsten Rendering-Paint (auf die nächsten 8 ms gerundet).

first-input

Die Zeit vom startTime des 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 loadEventEnd und startTime des Eintrags.

resource

Der Wert von responseEnd des Eintrags abzüglich des Werts von startTime des Eintrags.

Für die folgenden Eintragstypen ist duration nicht anwendbar; der Wert ist in diesen Fällen immer 0:

  • container
  • element
  • largest-contentful-paint
  • layout-shift
  • mark
  • paint
  • taskattribution
  • visibility-state

Beispiele

Die duration-Eigenschaft verwenden

Das folgende Beispiel protokolliert alle beobachteten Performance-Einträge mit einer duration größer als 0.

js
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

Browser-Kompatibilität