DOMPointReadOnly: 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 DOMPointReadOnly gibt ein JSON-serialisierbares einfaches Objekt zurück, das das DOMPointReadOnly-Objekt repräsentiert.
Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein DOMPointReadOnly-Objekt vorkommt. Der serialisierte Wert kann anschließend mit der Funktion DOMPointReadOnly.fromPoint() im Reviver 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
toJSON() direkt aufrufen
Ein direkter Aufruf von toJSON() gibt ein einfaches Objekt mit den Eigenschaften des DOMPointReadOnly-Objekts zurück.
const point = new DOMPointReadOnly(10, 20);
const json = point.toJSON();
console.log(json);
// { x: 10, y: 20, z: 0, w: 1 }
console.log(typeof json); // "object"
In einen JSON-String serialisieren
Das DOMPointReadOnly-Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.
const pointJSON = JSON.stringify(point);
console.log(pointJSON);
Dadurch würde ein JSON-String wie der folgende ausgegeben (zur besseren Lesbarkeit formatiert):
{
"x": 10,
"y": 20,
"z": 0,
"w": 1
}
Spezifikationen
| Spezifikation |
|---|
| Geometry Interfaces Module Level 1 # dom-dompointreadonly-tojson |