iceconnectionstatechange

An iceconnectionstatechange event is sent to an RTCPeerConnection object when the state of its ICE connection changes. The new ICE connection state is available in the object's iceConnectionState} property.

An event handler for this event can be added using the RTCPeerConnection.oniceconnectionstatechange property or by using addEventListener() on the RTCPeerConnection.

One common task performed by the iceconnectionstatechange event listener: to trigger ICE restart when the state changes to "failed". See ICE restart in Lifetime of a WebRTC session for further information.

General info

Specification

WebRTC 1.0: Real-time Communication Between Browsers
The definition of 'iceconnectionstatechange' in that specification.

Interface

Event

Bubbles

No

Cancelable

No

Target

RTCPeerConnection

Default Action

None

Properties

This event implements the properties of Event.

Methods

This event implements the methods of Event.

Related events

• none

Specifications

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

See also

• WebRTC API
• RTCPeerConnection
• RTCPeerConnection.onIceConnectionStateChange
• RTCPeerConnection.iceConnectionState