DOMRectReadOnly: Methode toJSON()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode toJSON() der Schnittstelle DOMRectReadOnly gibt ein JSON-serialisierbares einfaches Objekt zurück, das das DOMRectReadOnly-Objekt repräsentiert.
Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein DOMRectReadOnly-Objekt angetroffen wird. Der serialisierte Wert kann anschließend mit der Funktion DOMRectReadOnly.fromRect() innerhalb des Revivers von JSON.parse() deserialisiert werden.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein JSON-serialisierbares einfaches Objekt mit den folgenden Eigenschaften:
Der Wert jeder Eigenschaft wird unverändert kopiert.
Beispiele
Direkter Aufruf von toJSON()
Ein direkter Aufruf von toJSON() gibt ein einfaches Objekt zurück, das die Eigenschaften des DOMRectReadOnly-Objekts enthält.
const rect = new DOMRectReadOnly(10, 20, 100, 50);
const json = rect.toJSON();
console.log(json);
// { x: 10, y: 20, width: 100, height: 50, top: 20, right: 110, bottom: 70, left: 10 }
console.log(typeof json); // "object"
Serialisierung zu einer JSON-Zeichenfolge
Das DOMRectReadOnly-Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.
const rectJSON = JSON.stringify(rect);
console.log(rectJSON);
Dabei würde eine JSON-Zeichenfolge wie die folgende ausgegeben (zur besseren Lesbarkeit formatiert):
{
"x": 10,
"y": 20,
"width": 100,
"height": 50,
"top": 20,
"right": 110,
"bottom": 70,
"left": 10
}
Spezifikationen
| Spezifikation |
|---|
| Geometry Interfaces Module Level 1 # dom-domrectreadonly-tojson |