RTCDtlsTransport: error event
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
AnRTCDtlsTransport
receives anerror
event when a transport-level error occurs on theRTCPeerConnection
.
This event is not cancelable and does not bubble.
Syntax
Use the event name in methods likeaddEventListener()
, or set an event handler property.
addEventListener("error", (event) => { })onerror = (event) => { }
Event type
AnRTCErrorEvent
. Inherits fromEvent
.
Event properties
In addition to the standard properties available on theEvent
interface,RTCErrorEvent
also includes the following:
Description
Transport-level errors will have one of the following values for the specified error'sRTCError
propertyerrorDetail
:
dtls-failure
The negotiation of theDTLS connection failed, or the connection was terminated with a fatal error. The error's
message
contains details about the nature of the error. If a fatal error isreceived, the error object'sreceivedAlert
property is set to the value of the DTLSL alert received. If, on the other hand, a fatal error wassent, thesentAlert
is set to the alert's value.fingerprint-failure
The remote certificate for the
RTCDtlsTransport
didn'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-failure
error.
Examples
Specifications
No specification found
No specification data found forapi.RTCDtlsTransport.error_event
.
Check for problems with this page or contribute a missingspec_url
tomdn/browser-compat-data. Also make sure the specification is included inw3c/browser-specs.