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 und startTime des Eintrags.

resource

Der Wert von responseEnd des Eintrags minus dem Wert von startTime 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.

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

Specification
Performance Timeline
# dom-performanceentry-duration

Browser-Kompatibilität

BCD tables only load in the browser