WebRTC
The connectionstatechange event is sent to the onconnectionstatechange event handler on an RTCPeerConnection object after a new track has been added to an RTCRtpReceiver which is part of the connection.
The new connection state can be found in RTCPeerConnection.connectionState, and is one of the string values: new, connecting, connected, disconnected, failed, or closed.
This event is not cancelable and does not bubble.
Syntax
Use the event name in EventTarget/addEventListener:
addEventListener("connectionstatechange", (event) => { })
Alternatively, assign to the event handler property of the interface:
onconnectionstatechange = (event) => { }
Event type
A generic Event.
Examples
For an RTCPeerConnection named peerConnection, this example uses EventTarget.addEventListener to handle changes to the connectivity of the WebRTC session.
It calls an app-defined function called setOnlineStatus() to update a status display.
peerConnection.addEventListener("connectionstatechange", (event) => {
switch (peerConnection.connectionState) {
case "new":
case "connecting":
setOnlineStatus("Connecting…");
break;
case "connected":
setOnlineStatus("Online");
break;
case "disconnected":
setOnlineStatus("Disconnecting…");
break;
case "closed":
setOnlineStatus("Offline");
break;
case "failed":
setOnlineStatus("Error");
break;
default:
setOnlineStatus("Unknown");
break;
}
});
You can also create a handler for the connectionstatechange event using the RTCPeerConnection.onconnectionstatechange property (but note that this replaces other event listeners added using onconnectionstatechange, if any):
peerConnection.onconnectionstatechange = (ev) => {
switch (peerConnection.connectionState) {
case "new":
case "connecting":
setOnlineStatus("Connecting…");
break;
// …
default:
setOnlineStatus("Unknown");
break;
}
};
Specifications
Browser compatibility
See also
- WebRTC API
- WebRTC connectivity
- Lifetime of a WebRTC session
- RTCPeerConnection.connectionState
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
