WebRTC
A statechange event occurs when the RTCIceTransport changes state. The RTCIceTransport.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.
This event is not cancelable and does not bubble.
Syntax
Use the event name in EventTarget/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 ICE transport enters a failure state.
let iceTransport = pc.getSenders()[0].transport.iceTransport;
iceTransport.addEventListener("statechange", (ev) => {
if (iceTransport.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):
let iceTransport = pc.getSenders()[0].transport.iceTransport;
iceTransport.onstatechange = (ev) => {
if (iceTransport.state === "failed") {
handleFailure(pc);
}
};
Specifications
Browser compatibility
See also
Related RTCIceTransport events
- RTCIceTransport.gatheringstatechange_event
- RTCIceTransport.selectedcandidatepairchange_event
Related RTCPeerConnection events
- RTCPeerConnection.negotiationneeded_event
- RTCPeerConnection.signalingstatechange_event
- RTCPeerConnection.iceconnectionstatechange_event
- RTCPeerConnection.icegatheringstatechange_event
- RTCPeerConnection.connectionstatechange_event
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
