RTCPeerConnection: pendingRemoteDescription 属性

Baseline 已广泛支持

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

pendingRemoteDescriptionRTCPeerConnection 接口的一个只读属性,它返回一个 RTCSessionDescription 对象,该对象描述了连接远程端点的一个待处理的配置更改。

这并不描述连接当前的状态,而是描述连接在不久的将来可能的状态。使用 RTCPeerConnection.currentRemoteDescriptionRTCPeerConnection.remoteDescription 来获取远程端点的当前会话描述。有关它们之间区别的详细信息,请参阅 WebRTC 连接页面中的 待处理和当前描述

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

示例

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

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

规范

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

浏览器兼容性

注意: pendingRemoteDescriptioncurrentRemoteDescription 添加到 WebRTC 规范中是相对较新的。在不支持它们的浏览器中,只有 remoteDescription 可用。

另见