MDN self-hosted library · e01.org

RTCDtlsTransport: statechange event

WebRTC

WebRTC

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 addEventListener():

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

Alternatively, assign to the event handler property of the interface:

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 (but note that this replaces other event listeners added using onstatechange, if any):

const dtlsTransport = pc.getSenders()[0].transport;

dtlsTransport.onstatechange = (ev) => {
  if (dtlsTransport.state === "failed") {
    handleFailure(pc);
  }
};

Specifications

Browser compatibility

See also