PerformanceServerTiming: duration-Eigenschaft

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die schreibgeschützte Eigenschaft duration gibt eine Gleitkommazahl zurück, die die vom Server angegebene Metrikdauer oder den Wert 0.0 enthält.

Wert

Eine Zahl.

Beispiele

Protokollierung von Server-Timing-Einträgen

Server-Timing-Metriken erfordern, dass der Server den Server-Timing-Header sendet. Zum Beispiel:

http
Server-Timing: cache;desc="Cache Read";dur=23.2

Die serverTiming-Einträge können in navigation- und resource-Einträgen vorhanden sein.

Beispiel mit einem PerformanceObserver, der über neue navigation- und resource-Leistungseinträge informiert, während sie in der Leistungstimeline des Browsers aufgezeichnet werden. Verwenden Sie die buffered-Option, um auf Einträge vor der Erstellung des Observers zuzugreifen.

js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    entry.serverTiming.forEach((serverEntry) => {
      console.log(
        `${serverEntry.name} (${serverEntry.description}) duration: ${serverEntry.duration}`,
      );
      // Logs "cache (Cache Read) duration: 23.2"
    });
  });
});

["navigation", "resource"].forEach((type) =>
  observer.observe({ type, buffered: true }),
);

Beispiel mit Performance.getEntriesByType(), das nur navigation- und resource-Leistungseinträge anzeigt, die zum Zeitpunkt des Aufrufs dieser Methode in der Leistungstimeline des Browsers vorhanden sind:

js
for (const entryType of ["navigation", "resource"]) {
  for (const { name: url, serverTiming } of performance.getEntriesByType(
    entryType,
  )) {
    if (serverTiming) {
      for (const { name, description, duration } of serverTiming) {
        console.log(`${name} (${description}) duration: ${duration}`);
        // Logs "cache (Cache Read) duration: 23.2"
      }
    }
  }
}

Spezifikationen

Specification
Server Timing
# dom-performanceservertiming-duration

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch