RTCSessionDescription: Methode toJSON()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die Methode toJSON() der Schnittstelle RTCSessionDescription gibt ein JSON-serialisierbares einfaches Objekt zurück, das das RTCSessionDescription-Objekt repräsentiert.
Die Methode wird von JSON.stringify() automatisch aufgerufen, wenn bei der JSON-Serialisierung ein RTCSessionDescription-Objekt angetroffen wird.
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
Dieses Beispiel erstellt ein RTCSessionDescription-Objekt. Ein direkter Aufruf von toJSON() gibt ein einfaches Objekt zurück. Seine Eigenschaften haben dieselben Werte wie die entsprechenden Eigenschaften des ursprünglichen Objekts.
const description = new RTCSessionDescription({ type: "rollback", sdp: "" });
const json = description.toJSON();
console.log(json); // A plain object
console.log(typeof json); // "object"
console.log(json.type); // Same value as description.type
In einen JSON-String serialisieren
Das RTCSessionDescription-Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.
console.log(JSON.stringify(description));
Dies würde einen JSON-String wie den folgenden ausgeben (zur besseren Lesbarkeit formatiert):
{
"type": "rollback",
"sdp": ""
}
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcsessiondescription-tojson |