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 erhält ein error-Ereignis, wenn ein Fehler auf der Transporteebene bei der RTCPeerConnection auftritt.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergeleitet.

Syntax

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

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

onerror = (event) => { }

Neben den standardmäßigen Eigenschaften, die auf der Event-Schnittstelle verfügbar sind, enthält RTCErrorEvent auch die folgenden:

error Schreibgeschützt: Ein RTCError-Objekt, das den aufgetretenen Fehler angibt; dieses Objekt enthält den Fehler-Typ, Informationen über den Ort des Fehlers (wie z.B. welche Zeilennummer im SDP oder welcher SCTP-Ursachencode betroffen war).

Fehler auf der Transporteebene werden einen der folgenden Werte für die spezifische Fehler RTCError-Eigenschaft errorDetail haben:

dtls-failure: Die Aushandlung der DTLS-Verbindung ist fehlgeschlagen 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 der empfangenen DTLSL-Warnung gesetzt. Wenn hingegen ein schwerwiegender Fehler gesendet wurde, wird sentAlert auf den Wert der Warnung gesetzt.
fingerprint-failure: Das entfernte Zertifikat für den RTCDtlsTransport stimmte nicht mit einem der im SDP aufgeführten Fingerabdrücke überein. Wenn das entfernte Peering das lokale Zertifikat nicht mit den bereitgestellten Fingerabdrücken abgleichen kann, tritt dieser Fehler nicht auf, obwohl dies stattdessen zu einem dtls-failure führen kann.

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

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

  // …
};

Hinweis: Da RTCError nicht zu den veralteten Fehlern gehört, ist der Wert von code immer 0.

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.