PerformanceLongAnimationFrameTiming: Methode toJSON()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die Methode toJSON() der Schnittstelle PerformanceLongAnimationFrameTiming gibt ein JSON-serialisierbares einfaches Objekt zurück, das das PerformanceLongAnimationFrameTiming-Objekt repräsentiert.
Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein PerformanceLongAnimationFrameTiming-Objekt gefunden wird.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein JSON-serialisierbares einfaches Objekt mit den folgenden Eigenschaften:
nameentryTypestartTimedurationnavigationIdpaintTimepresentationTimerenderStartstyleAndLayoutStartfirstUIEventTimestampblockingDurationscripts
Der Wert jeder Eigenschaft wird unverändert übernommen. Wenn das zurückgegebene Objekt an JSON.stringify() übergeben wird, werden die Objekte im scripts-Array zusätzlich mit PerformanceScriptTiming.toJSON() serialisiert.
Beispiele
toJSON() direkt aufrufen
In diesem Beispiel wird ein PerformanceLongAnimationFrameTiming-Objekt abgerufen. Ein direkter Aufruf von toJSON() gibt ein einfaches Objekt zurück. Dessen Eigenschaften haben dieselben Werte wie die entsprechenden Eigenschaften des ursprünglichen Objekts.
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
const json = entry.toJSON();
console.log(json); // A plain object
console.log(typeof json); // "object"
console.log(json.blockingDuration); // Same value as entry.blockingDuration
});
});
observer.observe({ type: "long-animation-frame", buffered: true });
In eine JSON-Zeichenfolge serialisieren
Innerhalb der Callback-Funktion aus dem vorherigen Beispiel kann dasselbe Objekt mit JSON.stringify() serialisiert werden. Dabei wird die Methode toJSON() automatisch aufgerufen.
console.log(JSON.stringify(entry));
Dadurch würde eine JSON-Zeichenfolge wie die folgende protokolliert (zur besseren Lesbarkeit formatiert):
{
"name": "long-animation-frame",
"entryType": "long-animation-frame",
"startTime": 11802.25,
"duration": 60.5,
"navigationId": 2463,
"paintTime": 11862.75,
"presentationTime": 11868.5,
"renderStart": 11859.5,
"styleAndLayoutStart": 11859.5,
"firstUIEventTimestamp": 11801.25,
"blockingDuration": 2.5,
"scripts": [
{
"name": "script",
"entryType": "script",
"startTime": 11803.25,
"duration": 49.25,
"navigationId": 2463,
"invoker": "DOMWindow.onclick",
"invokerType": "event-listener",
"windowAttribution": "self",
"executionStart": 11803.25,
"forcedStyleAndLayoutDuration": 0.5,
"pauseDuration": 0.25,
"sourceURL": "https://web.dev/js/index-ffde4443.js",
"sourceFunctionName": "myClickHandler",
"sourceCharPosition": 17796
}
]
}
Spezifikationen
| Spezifikation |
|---|
| Long Animation Frames API # dom-performancelonganimationframetiming-tojson |