RTCPeerConnection.onconnectionstatechange

RTCPeerConnection.onconnectionstatechange 속성에 RTCPeerConnection 인스턴스에서 발생하는 connectionstatechange 이벤트를 처리하기 위해 호출되는 event handler를 정의하게됩니다. 이 이벤트는  연결의 상태 집합체가 변할 때마다 발생합니다. 이 상태 집합체는 연결에 의해 사용되는 각각의 네트워크 전송 상태들의 묶음입니다.

Syntax

RTCPeerConnection.onconnectionstatechange = eventHandler;

RTCPeerConnection에서 connectionstatechange 이벤트가 생길 때, 브라우저에 의해 호출되는 함수입니다. 이 함수는 Event 타입의 객체인 단일 패러미터를 입력인자로 받습니다. 해당 이벤트 객체는 특별한 정보를 담고 있지는 않습니다. 새로운 상태를 확인하려면 피어 연결의 connectionState에 해당하는 값을 살펴보십시오. 

예시

pc.onconnectionstatechange = function(event) {
  switch(pc.connectionState) {
    case "connected":
      // The connection has become fully connected
      break;
    case "disconnected":
    case "failed":
      // One or more transports has terminated unexpectedly or in an error
      break;
    case "closed":
      // The connection has been closed
      break;
  }
}

명세

명세 상태 코멘트
WebRTC 1.0: Real-time Communication Between Browsers
The definition of 'RTCPeerConnection.onconnectionstatechange' in that specification.
Candidate Recommendation Initial specification.

브라우저 호환성

BCD tables only load in the browser

참조