RTCPeerConnection: свойство localDescription

Чтение только свойство localDescription интерфейса RTCPeerConnection возвращает объект RTCSessionDescription, описывающий сеанс для локального конца соединения. Если оно еще не установлено, это null.

const sessionDescription = peerConnection.localDescription

На более фундаментальном уровне возвращаемое значение — это значение RTCPeerConnection.pendingLocalDescription, если это свойство не null; в противном случае возвращается значение RTCPeerConnection.currentLocalDescription. Подробности об этом алгоритме и причинах его использования см. в разделе «Ожидаемые и текущие описания» на странице «Соединение WebRTC».

В этом примере рассматривается localDescription и отображается всплывающее окно с полями type и sdp объекта RTCSessionDescription.

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.");
}

• RTCPeerConnection.setLocalDescription(), RTCPeerConnection.pendingLocalDescription, RTCPeerConnection.currentLocalDescription
• RTCPeerConnection.setRemoteDescription(), RTCPeerConnection.remoteDescription, RTCPeerConnection.pendingRemoteDescription, RTCPeerConnection.currentRemoteDescription
• WebRTC