RTCPeerConnection: свойство connectionState

Свойство connectionState только для чтения интерфейса RTCPeerConnection указывает текущее состояние подключения по peer, возвращая одно из следующих строковых значений: new, connecting, connected, disconnected, failed, или closed.

Это состояние в основном представляет собой совокупное состояние всех транспортных средств ICE (которые являются типами RTCIceTransport или RTCDtlsTransport), используемых подключением.

При изменении значения этого свойства событие connectionstatechange отправляется экземпляру RTCPeerConnection.

Значение

Строка, представляющая текущее состояние подключения. Она может принимать одно из следующих значений:

new: По меньшей мере, один из транспортных средств ICE подключения (RTCIceTransport или RTCDtlsTransport объекты) находится в состоянии new, и ни один из них не находится в одном из следующих состояний: connecting, checking, failed, disconnected, или все транспортные средства подключения находятся в состоянии closed.
connecting: Один или несколько транспортных средств ICE в настоящее время устанавливают подключение; то есть их iceConnectionState равно либо checking, либо connected, и ни один транспорт не находится в состоянии failed.
connected: Каждый транспорт ICE, используемый подключением, находится в активном состоянии (состояние connected или completed) или закрыт (состояние closed); кроме того, по меньшей мере, один транспорт находится в состоянии connected или completed.
disconnected: По крайней мере, один из транспортных средств ICE для подключения находится в состоянии disconnected и ни один из других транспортных средств не находится в состояниях: failed, connecting, или checking.
failed: Один или несколько транспортных средств ICE подключения находятся в состоянии failed.
closed: RTCPeerConnection закрыт.

Пример

const peerConnection = new RTCPeerConnection(configuration);

// …

const connectionState = peerConnection.connectionState;

Спецификации

Спецификация
WebRTC: Real-Time Communication in Browsers # dom-peerconnection-connection-state

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`connectionState`	72	79	113	60	11	72	113	51	11	11.0	72

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/connectionState