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-Interface stellt den STUN-Fehlercode dar, der vom STUN- oder TURN-Server zurückgegeben wird, wenn während der ICE-Aushandlung ein Fehler aufgetreten ist.
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 und nur gemeldet, während iceGatheringState den Wert gathering hat.
Beispiele
Grundlegende Verwendung
Dieses Beispiel erstellt einen Handler für icecandidateerror-Ereignisse, der menschenlesbare Meldungen erstellt, welche die lokale Netzwerkschnittstelle für die Verbindung und den ICE-Server beschreiben, der zum Versuch der Verbindungsherstellung verwendet wurde.
Anschließend ruft es eine Funktion auf, um diese Meldungen 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 |