RTCIceCandidate: 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 RTCIceCandidate gibt ein JSON-serialisierbares einfaches Objekt zurück, das das RTCIceCandidate-Objekt repräsentiert.
Die Methode wird von JSON.stringify() automatisch aufgerufen, wenn bei der JSON-Serialisierung ein RTCIceCandidate-Objekt vorkommt. Der serialisierte Wert kann anschließend mit dem Konstruktor RTCIceCandidate() innerhalb der Reviver-Funktion 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
Dieses Beispiel erstellt ein RTCIceCandidate-Objekt. 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 candidate = new RTCIceCandidate({
candidate: "",
sdpMid: "0",
sdpMLineIndex: 0,
});
const json = candidate.toJSON();
console.log(json); // A plain object
console.log(typeof json); // "object"
console.log(json.candidate); // Same value as candidate.candidate
In einen JSON-String serialisieren
Das RTCIceCandidate-Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.
const jsonString = JSON.stringify(candidate);
console.log(jsonString);
Dadurch würde ein JSON-String wie der folgende ausgegeben (zur besseren Lesbarkeit formatiert):
{
"candidate": "",
"sdpMid": "0",
"sdpMLineIndex": 0,
"usernameFragment": null
}
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcicecandidate-tojson |