RTCPeerConnection: pendingLocalDescription-Eigenschaft

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.

Die schreibgeschützte pendingLocalDescription-Eigenschaft des RTCPeerConnection-Interfaces gibt ein RTCSessionDescription-Objekt zurück, das eine anstehende Konfigurationsänderung für das lokale Ende der Verbindung beschreibt.

Dies beschreibt nicht die Verbindung, wie sie derzeit besteht, sondern wie sie in naher Zukunft existieren könnte. Verwenden Sie RTCPeerConnection.currentLocalDescription oder RTCPeerConnection.localDescription, um den aktuellen Zustand des Endpunkts zu erhalten. Details zu den Unterschieden finden Sie unter Anstehende und aktuelle Beschreibungen auf der WebRTC-Verbindungsseite.

Wert

Wenn eine lokale Beschreibung in Bearbeitung ist, handelt es sich um eine RTCSessionDescription, die die vorgeschlagene Konfiguration beschreibt. Andernfalls wird null zurückgegeben.

Beispiele

Dieses Beispiel überprüft die pendingLocalDescription, um festzustellen, ob eine Beschreibungsänderung verarbeitet wird.

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

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-peerconnection-pendinglocaldesc

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
pendingLocalDescription

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Hinweis: Die Hinzufügung von pendingLocalDescription und currentLocalDescription zur WebRTC-Spezifikation ist relativ neu. In Browsern, die sie nicht unterstützen, ist nur localDescription verfügbar.

Siehe auch