RTCPeerConnection: connectionState-Eigenschaft
Die schreibgeschützte connectionState
-Eigenschaft der RTCPeerConnection
-Schnittstelle gibt den aktuellen Zustand der Peer-Verbindung durch die Rückgabe eines der folgenden String-Werte an: new
, connecting
, connected
, disconnected
, failed
oder closed
.
Dieser Zustand repräsentiert im Wesentlichen den zusammengefassten Zustand aller ICE-Transporte (die vom Typ RTCIceTransport
oder RTCDtlsTransport
sind), die von der Verbindung verwendet werden.
Ändert sich der Wert dieser Eigenschaft, wird ein connectionstatechange
-Ereignis an die RTCPeerConnection
-Instanz gesendet.
Wert
Ein String, der den aktuellen Zustand der Verbindung darstellt. Dieser kann einen der folgenden Werte annehmen:
new
-
Mindestens einer der ICE Transports der Verbindung (
RTCIceTransport
oderRTCDtlsTransport
Objekte) befindet sich im Zustandnew
, und keiner von ihnen ist in einem der folgenden Zustände:connecting
,checking
,failed
,disconnected
, oder alle Transporte der Verbindung sind im Zustandclosed
. connecting
-
Einer oder mehrere der ICE Transports sind aktuell dabei, eine Verbindung herzustellen; das heißt, ihr
iceConnectionState
ist entwederchecking
oderconnected
, und keine Transporte befinden sich im Zustandfailed
. connected
-
Jeder ICE Transport, der von der Verbindung genutzt wird, ist entweder in Gebrauch (Zustand
connected
odercompleted
) oder ist geschlossen (Zustandclosed
); zusätzlich ist mindestens ein Transport entwederconnected
odercompleted
. disconnected
-
Mindestens einer der ICE Transports der Verbindung befindet sich im Zustand
disconnected
und keiner der anderen Transporte ist in den Zuständen:failed
,connecting
oderchecking
. failed
-
Einer oder mehrere der ICE Transports der Verbindung befinden sich im Zustand
failed
. closed
-
Die
RTCPeerConnection
ist geschlossen.
Beispiel
const peerConnection = new RTCPeerConnection(configuration);
// …
const connectionState = peerConnection.connectionState;
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # dom-peerconnection-connection-state |
Browser-Kompatibilität
BCD tables only load in the browser