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.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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

Dieses Ereignis ist nicht abbrechbar und verbreitet sich nicht.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

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

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 sucht speziell nach 701-Fehlern, die darauf hinweisen, dass Kandidaten den STUN- oder TURN-Server nicht erreichen konnten.

Wenn dies geschieht, werden die Server-URL und die Fehlermeldung an eine Funktion namens reportConnectFail() übergeben, um das Verbindungsproblem zu protokollieren oder auszugeben.

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

Beachten Sie, dass, wenn beim Erstellen der Verbindung mehrere STUN- und/oder TURN-Server bereitgestellt werden, dieser Fehler mehrmals auftreten kann, wenn mehr als einer dieser Server ausfällt. Jeder bereitgestellte Server wird ausprobiert, bis eine Verbindung hergestellt wird.