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 |