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.
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.