RTCPeerConnection: pendingRemoteDescription property
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.
ThependingRemoteDescription read-only property of theRTCPeerConnection interface returns anRTCSessionDescription object describing a pending configuration change for the remote end of the connection.
This does not describe the connection as it currently stands, but as it may exist in the near future.UseRTCPeerConnection.currentRemoteDescription orRTCPeerConnection.remoteDescription to get the current sessiondescription for the remote endpoint.For details on the difference, seePending and current descriptions in the WebRTC Connectivity page.
Value
If a remote description change is in progress, this is anRTCSessionDescription describing the proposed configuration.Otherwise, this returnsnull.
Examples
This example looks at thependingRemoteDescription to determine whether or not there's a description change being processed.
const pc = new RTCPeerConnection();// …const sd = pc.pendingRemoteDescription;if (sd) { // There's a description change underway!} else { // No description change pending}Specifications
| Specification |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-peerconnection-pendingremotedesc |
Browser compatibility
Note:The addition ofpendingRemoteDescription andcurrentRemoteDescription to the WebRTC spec is relatively recent.In browsers which don't support them, onlyremoteDescription is available.