RTCDtlsTransport: error-Ereignis

Ein RTCDtlsTransport empfängt ein error-Ereignis, wenn ein Transportfehler in der RTCPeerConnection auftritt.

Dieses Ereignis ist nicht abbrechbar und bubblet nicht.

Syntax

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

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

onerror = (event) => {};

Ereignistyp

Ereigniseigenschaften

Zusätzlich zu den Standard-Eigenschaften, die in der Event-Schnittstelle verfügbar sind, enthält RTCErrorEvent auch folgende:

error Nur lesbar

Ein RTCError-Objekt, das den aufgetretenen Fehler spezifiziert; dieses Objekt enthält den Fehlertyp, Informationen darüber, wo der Fehler aufgetreten ist (wie zum Beispiel welche Zeilennummer im SDP oder welcher SCTP-Ursachencode betroffen war).

Beschreibung

Transportfehler haben einen der folgenden Werte für die spezielle Fehler-Eigenschaft RTCError errorDetail:

dtls-failure

Die Aushandlung der DTLS-Verbindung schlug fehl oder die Verbindung wurde mit einem schwerwiegenden Fehler beendet. Die message des Fehlers enthält Details zur Art des Fehlers. Wenn ein schwerwiegender Fehler empfangen wird, wird die Eigenschaft receivedAlert des Fehlerobjekts auf den Wert des empfangenen DTLSL-Alarms gesetzt. Wenn andererseits ein schwerwiegender Fehler gesendet wurde, wird sentAlert auf den Wert des Alarms gesetzt.

fingerprint-failure

Das Remote-Zertifikat für das RTCDtlsTransport stimmte mit keinem der in der SDP aufgelisteten Fingerabdrücke überein. Kann das Remote-Peer das lokale Zertifikat nicht mit den bereitgestellten Fingerabdrücken abgleichen, tritt dieser Fehler nicht auf, obwohl diese Situation stattdessen zu einem dtls-failure-Fehler führen kann.

Beispiele

In diesem Beispiel wird die onerror-Ereignishandler-Eigenschaft verwendet, um den Handler für das error-Ereignis festzulegen.

js
transport.onerror = (ev) => {
  const err = ev.error;

  // …
};

Hinweis: Da RTCError kein Fehler aus der Legacy-Gruppe ist, hat der Wert von code immer den Wert 0.

Spezifikationen

No specification found

No specification data found for api.RTCDtlsTransport.error_event.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch