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

BCD tables only load in the browser

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