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 der Schnittstelle RTCPeerConnectionIceErrorEvent repräsentiert den STUN-Fehlercode, der vom STUN- oder TURN-Server zurückgegeben wird, wenn es während der ICE-Aushandlung zu einem Fehler gekommen ist.
Wert
Ein positiver Ganzzahlenwert, der den numerischen STUN-Fehlercode angibt, der vom STUN- oder TURN-Server zurückgegeben wurde.
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 gathering.
Beispiele
Grundlegende Verwendung
Dieses Beispiel erstellt einen Handler für icecandidateerror-Ereignisse, der menschenlesbare Meldungen beschreibt, die die lokale Netzwerkschnittstelle für die Verbindung und den ICE-Server, der versucht wurde, die Verbindung herzustellen.
Anschließend wird eine Funktion aufgerufen, 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 |