RTCSctpTransport: 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 May 2023.

See full compatibility
Learn more

A statechange event is sent to an RTCSctpTransport to provide notification when the RTCSctpTransport.state property has changed.

Syntax

Use the event name in addEventListener():

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

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

onstatechange = (event) => { }

Given an RTCSctpTransport, transport, and an updateStatus() function that presents connection state information to the user, this code sets up an event handler to let the user know when the transport is connected.

transport.addEventListener("statechange", (event) => {
  switch (transport.state) {
    case "connected":
      updateStatus("Connection started");
      break;
  }
});

Using onstatechange, it looks like this (but note that this replaces other event listeners added using onstatechange, if any):

transport.onstatechange = (event) => {
  switch (transport.state) {
    case "connected":
      updateStatus("Connection started");
      break;
  }
};