RTCDtlsTransport: error-Ereignis
Baseline 2026
Neu verfügbar
Seit August 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.
Ein RTCDtlsTransport empfängt ein error-Ereignis, wenn bei der RTCPeerConnection ein Fehler auf Transportebene auftritt.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht nach oben weitergegeben.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Event-Handler-Eigenschaft fest.
addEventListener("error", (event) => { })
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
messagedes Fehlers enthält Einzelheiten zur Art des Fehlers. Wenn ein schwerwiegender Fehler empfangen wurde, wird diereceivedAlert-Eigenschaft des Fehlerobjekts auf den Wert der empfangenen DTLS-Warnmeldung gesetzt. Wurde dagegen ein schwerwiegender Fehler gesendet, wirdsentAlertauf den Wert der Warnmeldung gesetzt. fingerprint-failure-
Das entfernte Zertifikat für den
RTCDtlsTransportstimmte mit keinem der im SDP aufgeführten Fingerabdrücke überein. Wenn die entfernte Gegenstelle das lokale Zertifikat keinem der angegebenen Fingerabdrücke zuordnen kann, tritt dieser Fehler nicht auf. Stattdessen kann es jedoch zu einemdtls-failure-Fehler kommen.
Beispiele
Grundlegende Verwendung
Der folgende Code verarbeitet einen DTLS-Transportfehler für eine RTCPeerConnection namens pc:
const dtlsTransport = pc.getSenders()[0].transport;
dtlsTransport.addEventListener("error", (ev) => {
const err = ev.error;
// …
});
Derselbe Code sieht bei Verwendung der Event-Handler-Eigenschaft onerror so aus:
dtlsTransport.onerror = (ev) => {
const err = ev.error;
// …
};
Hinweis:
Da RTCError nicht zu den Legacy-Fehlern gehört, ist der Wert von code immer 0.
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcdtlstransport-onerror |