RTCDtlsTransport: error event

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Ein RTCDtlsTransport empfängt ein error-Ereignis, wenn ein Transport-Level-Fehler auf der RTCPeerConnection auftritt.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergegeben.

Syntax

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

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

onerror = (event) => { }

Neben den Standard-Eigenschaften, die in der Event-Schnittstelle verfügbar sind, enthält RTCErrorEvent auch die folgenden:

error Schreibgeschützt: Ein RTCError-Objekt, das den aufgetretenen Fehler spezifiziert; dieses Objekt enthält den Fehlertyp, Informationen darüber, wo der Fehler aufgetreten ist (wie z.B. welche Zeilennummer im SDP oder welcher SCTP Ursache-Code betroffen war).

Transport-Level-Fehler haben einen der folgenden Werte für die angegebene errorDetail-Eigenschaft des RTCError:

dtls-failure: Die Aushandlung der DTLS-Verbindung ist fehlgeschlagen oder die Verbindung wurde mit einem fatalen Fehler beendet. Die message des Fehlers enthält Details zur Art des Fehlers. Wenn ein fataler Fehler empfangen wird, wird die receivedAlert-Eigenschaft des Fehlers auf den Wert des empfangenen DTLSL-Warnhinweises gesetzt. Wenn hingegen ein fataler Fehler gesendet wurde, wird sentAlert auf den Wert des Warnhinweises gesetzt.
fingerprint-failure: Das entfernte Zertifikat für das RTCDtlsTransport stimmt mit keinem der im SDP aufgeführten Fingerabdrücke überein. Wenn der entfernte Partner das lokale Zertifikat nicht mit den bereitgestellten Fingerabdrücken abgleichen kann, tritt dieser Fehler nicht auf, obwohl diese Situation stattdessen zu einem dtls-failure-Fehler führen kann.

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

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

  // …
};

Hinweis: Da RTCError keine der älteren Fehler ist, hat der Wert von code immer 0.

This feature does not appear to be defined in any specification.

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.