RTCPeerConnection: pendingLocalDescription-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
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.
const pc = new RTCPeerConnection();
// …
const sd = pc.pendingLocalDescription;
if (sd) {
// There's a description change underway!
} else {
// No description change pending
}
Spezifikationen
| Spezifikation |
|---|
| 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.