---
title: RTCPeerConnection.pendingLocalDescription
slug: Web/API/RTCPeerConnection/pendingLocalDescription
tags:
  - API
  - Media
  - Property
  - RTCPeerConnection
  - Read-only
  - Reference
  - SDP
  - WebRTC
  - pendingLocalDescription
browser-compat: api.RTCPeerConnection.pendingLocalDescription
---
{{APIRef("WebRTC")}}

The read-only property
**`RTCPeerConnection.pendingLocalDescription`** returns an
{{domxref("RTCSessionDescription")}} object describing a pending configuration change
for the local 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.currentLocalDescription")}} or
{{domxref("RTCPeerConnection.localDescription")}} to get the current state of the
endpoint. For details on the difference, see
{{SectionOnPage("/en-US/docs/Web/API/WebRTC_API/Connectivity", "Pending and current
  descriptions")}}.

## Syntax

```js
sessionDescription = RTCPeerConnection.pendingLocalDescription;
```

### Return value

If a local description change is in progress, this is an
{{domxref("RTCSessionDescription")}} describing the proposed configuration. Otherwise,
this returns `null`.

## Example

This example looks at the `pendingLocalDescription` to determine whether or
not there's a description change being processed.

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

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}

> **Note:** The addition of `pendingLocalDescription` and
> {{domxref("RTCPeerConnection.currentLocalDescription", "currentLocalDescription")}} to
> the WebRTC spec is relatively recent. In browsers which don't support them, only
> {{domxref("RTCPeerConnection.localDescription", "localDescription")}} is available.

## See also

- {{domxref("RTCPeerConnection.setLocalDescription()")}},
  {{domxref("RTCPeerConnection.currentLocalDescription")}},
  {{domxref("RTCPeerConnection.localDescription")}}
- {{domxref("RTCPeerConnection.setRemoteDescription()")}},
  {{domxref("RTCPeerConnection.remoteDescription")}},
  {{domxref("RTCPeerConnection.pendingRemoteDescription")}},
  {{domxref("RTCPeerConnection.currentRemoteDescription")}}
- [WebRTC](/en-US/docs/Web/Guide/API/WebRTC)
