PerformanceServerTiming: toJSON()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2023 browserübergreifend verfügbar.
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()
Parameter
Keine.
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:
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:
{
"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
| Spezifikation |
|---|
| Server Timing # dom-performanceservertiming-tojson |