PerformanceServerTiming: toJSON()-Methode

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 toJSON()-Methode des PerformanceServerTiming-Interfaces ist ein Serializer; sie gibt eine JSON-Darstellung des PerformanceServerTiming-Objekts zurück.

Syntax

toJSON()

Rückgabewert

Ein JSON-Objekt, das die Serialisierung des PerformanceServerTiming-Objekts ist.

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 sich in navigation und resource Einträgen befinden.

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

const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    entry.serverTiming.forEach((serverEntry) => {
      console.log(serverEntry.toJSON());
    });
  });
});

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

Dies würde ein JSON-Objekt wie folgt protokollieren:

json

{
  "name": "cache",
  "duration": 23.2,
  "description": "Cache Read"
}

Um einen JSON-String zu erhalten, können Sie JSON.stringify(serverEntry) direkt verwenden; es ruft automatisch toJSON() auf.

Spezifikationen

Specification
Server Timing # dom-performanceservertiming-tojson

Browser-Kompatibilität

BCD tables only load in the browser