RTCPeerConnection: icecandidateerror-Ereignis

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.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Das Ereignis icecandidateerror wird an eine RTCPeerConnection gesendet, wenn bei der ICE-Aushandlung über einen STUN- oder TURN-Server ein Fehler auftritt.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht nach oben weitergegeben.

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

addEventListener("icecandidateerror", (event) => { })

Alternativ können Sie die Event-Handler-Eigenschaft der Schnittstelle verwenden:

onicecandidateerror = (event) => { }

Ereignistyp

Ein RTCPeerConnectionIceErrorEvent. Erbt von Event.

Das folgende Beispiel richtet einen Handler für icecandidateerror-Ereignisse ein, die bei der RTCPeerConnection pc auftreten. Dieser Handler prüft gezielt auf Fehler mit dem Code 701, die darauf hinweisen, dass Kandidaten den STUN- oder TURN-Server nicht erreichen konnten.

In diesem Fall werden die Server-URL und die Fehlermeldung an eine Funktion namens reportConnectFail() übergeben, um den Verbindungsfehler zu protokollieren oder auszugeben.

pc.addEventListener("icecandidateerror", (event) => {
  if (event.errorCode === 701) {
    reportConnectFail(event.url, event.errorText);
  }
});

Beachten Sie, dass dieser Fehler mehrfach auftreten kann, wenn beim Erstellen der Verbindung mehrere STUN- und/oder TURN-Server angegeben wurden und mehr als einer dieser Server nicht erreichbar ist. Jeder angegebene Server wird ausprobiert, bis eine Verbindung hergestellt ist.