RTCPeerConnection:localDescription 属性

Baseline 已广泛支持

此功能已成熟,可跨多种设备和浏览器版本使用。自 2017 年 9 月以来,它已在浏览器中提供。

RTCPeerConnection 接口的只读属性 localDescription 返回一个 RTCSessionDescription 对象,该对象描述了连接本地端的会话。如果尚未设置,则为 null

从更根本的层面来说,返回值是 RTCPeerConnection.pendingLocalDescription 的值(如果该属性不是 null);否则,将返回 RTCPeerConnection.currentLocalDescription 的值。有关此算法及其使用原因的详细信息,请参阅 WebRTC 连接页面上的 待处理和当前描述

示例

此示例查看 localDescription 并显示一个包含 RTCSessionDescription 对象的 typesdp 字段的警报。

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

规范

规范
WebRTC:浏览器中的实时通信
# dom-peerconnection-localdescription

浏览器兼容性

另见