RTCIceTransport: statechange event

A statechange event occurs when the RTCIceTransport changes state. The state can be used to determine how far through the process of examining, verifying, and selecting a valid candidate pair is prior to successfully connecting the two peers for WebRTC communications.

Examples

Given an RTCPeerConnection, pc, the following code creates an event handler that calls a function named handleFailure() if the ICE transport enters a failure state.

let iceTransport = pc.getSenders()[0].transport.iceTransport;

iceTransport.addEventListener("statechange", ev => {
  if (iceTransport.state === "failed") {
    handleFailure(pc);
  }
}, false);

The same code, using the onstatechange event handler property, looks like this:

let iceTransport = pc.getSenders()[0].transport.iceTransport;

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

Specifications

Browser compatibility

See also

• WebRTC API
• WebRTC connectivity
• RTCIceTransport.onstatechange event handler

Related RTCIceTransport events

• gatheringstatechange
• selectedcandidatepairchange

Related RTCPeerConnection events

• negotiationneeded
• signalingstatechange
• iceconnectionstatechange
• icegatheringstatechange
• connectionstatechange