RTCPeerConnectionIceErrorEvent: errorCode-Eigenschaft
Baseline
2026
Neu verfügbar
Seit April 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die errorCode-Eigenschaft des RTCPeerConnectionIceErrorEvent-Interfaces repräsentiert den STUN-Fehlercode, der vom STUN oder TURN-Server zurückgegeben wird, wenn während der ICE-Verhandlung ein Fehler auftritt.
Wert
Ein positiver ganzzahliger Wert, der den numerischen STUN-Fehlercode angibt, der vom STUN- oder TURN-Server zurückgegeben wird.
Wenn kein Host-Kandidat den Server erreichen kann, wird diese Eigenschaft auf die Zahl 701 gesetzt, die außerhalb des Bereichs gültiger STUN-Fehlercodes liegt.
Dieser Wert wird nur einmal pro Server-URL gemeldet und nur, während der iceGatheringState auf gathering steht.
Beispiele
Grundlegende Verwendung
Dieses Beispiel erstellt einen Handler für icecandidateerror-Ereignisse, der lesbare Nachrichten erstellt, die die lokale Netzwerkschnittstelle für die Verbindung und den ICE-Server beschreiben, der für den Verbindungsversuch verwendet wird.
Anschließend wird eine Funktion aufgerufen, um diese Nachrichten und den Wert der errorCode-Eigenschaft des Ereignisses anzuzeigen.
pc.addEventListener("icecandidateerror", (event) => {
const networkInfo = `[Local interface: ${event.address}:${event.port}]`;
const iceServerInfo = `[ICE server: ${event.url}]`;
showMessage(event.errorCode, iceServerInfo, networkInfo);
});
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcpeerconnectioniceerrorevent-errorcode |