RTCDtlsTransport: statechange event
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.
A statechange event occurs when the RTCDtlsTransport changes state. The state property can be used to determine the current state of the underlying Datagram Transport Layer Security (DTLS) transport.
This event is not cancelable and does not bubble.
Syntax
Use the event name in methods like addEventListener(), or set an event handler property.
addEventListener("statechange", (event) => { })
onstatechange = (event) => { }
Event type
A generic Event.
Examples
Given an RTCPeerConnection, pc, the following code creates an event handler that calls a function named handleFailure() if the DTLS transport enters a failure state.
const dtlsTransport = pc.getSenders()[0].transport;
dtlsTransport.addEventListener("statechange", (ev) => {
if (dtlsTransport.state === "failed") {
handleFailure(pc);
}
});
The same code, using the onstatechange event handler property, looks like this:
const dtlsTransport = pc.getSenders()[0].transport;
dtlsTransport.onstatechange = (ev) => {
if (dtlsTransport.state === "failed") {
handleFailure(pc);
}
};
Specifications
This feature does not appear to be defined in any specification.Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
statechange event
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Uses a non-standard name
- Has more compatibility info.