RTCDtlsTransport: error event
An RTCDtlsTransport receives an error event when a transport-level error occurs on the RTCPeerConnection.
| Bubbles | Yes |
|---|---|
| Cancelable | No |
| Interface | RTCErrorEvent |
| Event handler property | onerror |
The RTCErrorEvent object provides details about the error that occurred; see that article for details.
Description
Transport-level errors will have one of the following values for the specified error's RTCError property errorDetail:
dtls-failure-
The negotiation of the DTLS connection failed, or the connection was terminated with a fatal error. The error's
messagecontains details about the nature of the error. If a fatal error is received, the error object'sreceivedAlertproperty is set to the value of the DTLSL alert received. If, on the other hand, a fatal error was sent, thesentAlertis set to the alert's value. fingerprint-failure-
The remote certificate for the
RTCDtlsTransportdidn't match any of the fingerprints listed in the SDP. If the remote peer can't match the local certificate against the provided fingerprints, this error doesn't occur, though this situation may result instead in adtls-failureerror.
Examples
In this example, the onerror event handler property is used to set the handler for the error event.
transport.onerror = ev => { const err = ev.error; /* ... */ }
Note: Since RTCError is not one of the legacy errors, the value of code is always 0.
Specifications
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 compatibility
No compatibility data found for api.RTCDtlsTransport.error_event.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCDtlsTransport/error_event