PerformanceServerTiming: description-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: Diese Funktion ist in Web Workers verfügbar.

Die schreibgeschützte description-Eigenschaft gibt einen Zeichenfolgenwert der vom Server festgelegten Metrikbeschreibung oder eine leere Zeichenfolge zurück.

Wert

Eine Zeichenfolge.

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 vorkommen.

Beispiel mit einem PerformanceObserver, der über neue navigation- und resource-Performance-Einträge benachrichtigt, während diese in der Performance-Zeitleiste des Browsers aufgezeichnet werden. Verwenden Sie die Option buffered, um auf Einträge zuzugreifen, die vor der Erstellung des Observers existierten.

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-Performance-Einträge anzeigt, die zum Zeitpunkt des Aufrufs dieser Methode in der Performance-Zeitleiste 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-description

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
description

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch