RTCDtlsTransport: error-Ereignis

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

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

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

onerror = (event) => { }

Ereignistyp

Ein RTCErrorEvent. Erbt von Event.

Beschreibung

Bei Fehlern auf Transportebene hat die errorDetail-Eigenschaft des zugehörigen RTCError einen der folgenden Werte:

dtls-failure

Die Aushandlung der DTLS-Verbindung ist fehlgeschlagen oder die Verbindung wurde aufgrund eines schwerwiegenden Fehlers beendet. Die message des Fehlers enthält Einzelheiten zur Art des Fehlers. Wenn ein schwerwiegender Fehler empfangen wurde, wird die receivedAlert-Eigenschaft des Fehlerobjekts auf den Wert des empfangenen DTLS-Alerts gesetzt. Wenn dagegen ein schwerwiegender Fehler gesendet wurde, wird sentAlert auf den Wert des Alerts gesetzt.

fingerprint-failure

Das Remote-Zertifikat für den RTCDtlsTransport stimmte mit keinem der im SDP aufgeführten Fingerprints überein. Wenn die Gegenstelle das lokale Zertifikat keinem der bereitgestellten Fingerprints zuordnen kann, tritt dieser Fehler nicht auf. Stattdessen kann in diesem Fall ein dtls-failure-Fehler auftreten.

Beispiele

Grundlegende Verwendung

Für eine RTCPeerConnection namens pc behandelt der folgende Code einen DTLS-Transportfehler:

const dtlsTransport = pc.getSenders()[0].transport;

dtlsTransport.addEventListener("error", (ev) => {
  const err = ev.error;
  // …
});

Derselbe Code sieht mit der Event-Handler-Eigenschaft onerror wie folgt aus. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über onerror hinzugefügte Event-Listener ersetzt werden:

dtlsTransport.onerror = (ev) => {
  const err = ev.error;
  // …
};

Spezifikationen

Browser-Kompatibilität

Siehe auch

• WebRTC API