RTCPeerConnection.localDescription

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

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

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

Syntax

js
const sessionDescription = peerConnection.localDescription;

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

예시

아래의 예시에서는 localDescription를 확인하고, RTCSessionDescription 객체의 타입과 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

참조