RTCPeerConnection: pendingLocalDescription 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

RTCPeerConnection 接口的只读属性 pendingLocalDescription 返回一个 RTCSessionDescription 对象,该对象描述了连接本地端的待处理配置更改。

这并不描述连接当前的实际状态,而是描述它在不久的将来可能存在的方式。请使用 RTCPeerConnection.currentLocalDescriptionRTCPeerConnection.localDescription 来获取端点的当前状态。有关差异的详细信息,请参阅 WebRTC 连接页面中的 待处理和当前描述

如果本地描述更改正在进行中,则这是一个描述建议配置的 RTCSessionDescription 对象。否则,将返回 null

示例

此示例检查 pendingLocalDescription 以确定是否正在处理描述更改。

js
const pc = new RTCPeerConnection();
// …
const sd = pc.pendingLocalDescription;
if (sd) {
  // There's a description change underway!
} else {
  // No description change pending
}

规范

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

浏览器兼容性

注意: pendingLocalDescriptioncurrentLocalDescription 添加到 WebRTC 规范是一个相对较新的功能。在不支持这些属性的浏览器中,只有 localDescription 可用。

另见