RTCPeerConnection.connectionState
The read-only connectionState
property
of the RTCPeerConnection
interface
indicates the current state of the peer connection
by returning one of the following string values:
new
, connecting
, connected
, disconnected
,
failed
, or closed
.
This state essentially represents the aggregate state of all ICE transports
(which are of type RTCIceTransport
or RTCDtlsTransport
)
being used by the connection.
When this property's value changes,
a connectionstatechange
event
is sent to the RTCPeerConnection
instance.
Syntax
var connectionState = RTCPeerConnection.connectionState;
Value
A string representing the current state of the connection, that is one of the following literals:
new
-
At least one of the connection's ICE transports (
RTCIceTransport
orRTCDtlsTransport
objects) is in thenew
state, and none of them are in one of the following states:connecting
,checking
,failed
,disconnected
, or all of the connection's transports are in theclosed
state. connecting
-
One or more of the ICE transports are currently in the process of establishing a connection; that is, their
iceConnectionState
is eitherchecking
orconnected
, and no transports are in thefailed
state. connected
-
Every ICE transport used by the connection is either in use (state
connected
orcompleted
) or is closed (stateclosed
); in addition, at least one transport is eitherconnected
orcompleted
. disconnected
-
At least one of the ICE transports for the connection is in the
disconnected
state and none of the other transports are in the statefailed
,connecting
, orchecking
. failed
-
One or more of the ICE transports on the connection is in the
failed
state. closed
-
The
RTCPeerConnection
is closed.
Example
var pc = new RTCPeerConnection(configuration);
/* ... */
var connectionState = pc.connectionState;
Specifications
Specification |
---|
WebRTC 1.0: Real-Time Communication Between Browsers # dom-peerconnection-connection-state |
Browser compatibility
BCD tables only load in the browser