RTCPeerConnection.localDescription

실험적: 이 기능은 실험적인 기능입니다.
프로덕션 환경에서 사용하기 전에 브라우저 호환성 표를 주의 깊게 확인하세요.

읽기 속성인 RTCPeerConnection.localDescription는 연결의 로컬 엔드에 대한 세션을 설명하는 RTCSessionDescription (en-US)를 반환합니다. 아직 설정이 안되어있다면, null 입니다.

Syntax

js
const sessionDescription = peerConnection.localDescription;

기본적으로 반환 값은 해당 속성이 null이 아닐 때에만 RTCPeerConnection.pendingLocalDescription (en-US)의 값입니다. 그렇지 않은 경우에는 RTCPeerConnection.currentLocalDescription의 값이 반환됩니다. 이 알고리즘 및 사용하는 이유에 대한 자세한 설명은 Pending and current descriptions (en-US)를 참조하십시오.

예시

아래의 예시에서는 localDescription를 확인하고, RTCSessionDescription (en-US) 객체의 타입과 sdp필드를 담고있는 경고를 띄웁니다.

js
const pc = new RTCPeerConnection();
// ...
const sd = pc.localDescription;
if (sd) {
  alert(`Local session: type='${sd.type}'; sdp description='${sd.sdp}'`);
} else {
  alert("No local session yet.");
}

명세서

Specification
WebRTC: Real-Time Communication in Browsers
# dom-peerconnection-localdescription

브라우저 호환성

BCD tables only load in the browser

참조