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 Eigenschaft pendingLocalDescription der RTCPeerConnection-Schnittstelle gibt ein RTCSessionDescription-Objekt zurück, das eine ausstehende Konfigurationsänderung für das lokale Ende der Verbindung beschreibt.

Dies beschreibt nicht den aktuellen Zustand der Verbindung, sondern wie sie in naher Zukunft existieren könnte. Verwenden Sie RTCPeerConnection.currentLocalDescription oder RTCPeerConnection.localDescription, um den aktuellen Zustand des Endpunkts zu erhalten. Einzelheiten zu den Unterschieden finden Sie unter Pending and current descriptions auf der WebRTC Connectivity-Seite.

Wert

Wenn eine lokale Beschreibung geändert wird, handelt es sich um ein RTCSessionDescription, das die vorgeschlagene Konfiguration beschreibt. Andernfalls wird null zurückgegeben.

Beispiele

Dieses Beispiel betrachtet die pendingLocalDescription, um zu bestimmen, 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

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

Siehe auch