RTCPeerConnectionIceErrorEvent: errorText-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 errorText-Eigenschaft des RTCPeerConnectionIceErrorEvent-Interfaces stellt den STUN-Fehlerbegründungstext dar, der vom STUN- oder TURN-Server zurückgegeben wird, wenn während der ICE-Aushandlung ein Fehler aufgetreten ist.
Falls keine Kommunikation mit dem STUN- oder TURN-Server hergestellt werden konnte, ist dies ein browserspezifischer String, der den Fehler erklärt.
Wert
Ein String, der vom STUN- oder TURN-Server zurückgegeben wird, oder ein browserspezifischer String, der erklärt, warum die Kommunikation mit dem Server nicht hergestellt werden konnte.
Beispiele
>Grundlegende Verwendung
Dieses Beispiel erstellt einen Handler für icecandidateerror-Ereignisse, der menschenlesbare Nachrichten erzeugt, die das lokale Netzwerkinterface für die Verbindung und den ICE-Server beschreiben, der zur Herstellung der Verbindung verwendet wurde.
Anschließend wird eine Funktion aufgerufen, um diese Nachrichten und den Wert der errorText-Eigenschaft des Ereignisses anzuzeigen.
pc.addEventListener("icecandidateerror", (event) => {
const networkInfo = `[Local interface: ${event.address}:${event.port}]`;
const iceServerInfo = `[ICE server: ${event.url}]`;
showMessage(event.errorText, iceServerInfo, networkInfo);
});
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers> # dom-rtcpeerconnectioniceerrorevent-errortext> |