files/en-us/web/api/rtcpeerconnection/pendingremotedescription/index.md
{{APIRef("WebRTC")}}
The pendingRemoteDescription read-only property of the {{domxref("RTCPeerConnection")}} interface returns an {{domxref("RTCSessionDescription")}} 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. Use {{domxref("RTCPeerConnection.currentRemoteDescription")}} or {{domxref("RTCPeerConnection.remoteDescription")}} to get the current session description for the remote endpoint. For details on the difference, see Pending and current descriptions in the WebRTC Connectivity page.
If a remote description change is in progress, this is an {{domxref("RTCSessionDescription")}} describing the proposed configuration.
Otherwise, this returns null.
This example looks at the pendingRemoteDescription 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}}
{{Compat}}
[!NOTE] The addition of
pendingRemoteDescriptionand {{domxref("RTCPeerConnection.currentRemoteDescription", "currentRemoteDescription")}} to the WebRTC spec is relatively recent. In browsers which don't support them, only {{domxref("RTCPeerConnection.remoteDescription", "remoteDescription")}} is available.