RTCPeerConnection: pendingRemoteDescription-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 pendingRemoteDescription
der Schnittstelle RTCPeerConnection
gibt ein RTCSessionDescription
-Objekt zurück, das eine bevorstehende Konfigurationsänderung für das entfernte Ende der Verbindung beschreibt.
Dies beschreibt nicht die aktuelle Verbindung, sondern wie sie in naher Zukunft existieren könnte. Verwenden Sie RTCPeerConnection.currentRemoteDescription
oder RTCPeerConnection.remoteDescription
, um die aktuelle Sitzungsbeschreibung für den entfernten Endpunkt zu erhalten.
Weitere Informationen zu den Unterschieden finden Sie unter Bevorstehende und aktuelle Beschreibungen auf der WebRTC-Konnektivitätsseite.
Wert
Wenn eine Änderung der entfernten Beschreibung im Gange ist, handelt es sich um ein RTCSessionDescription
, das die vorgeschlagene Konfiguration beschreibt.
Andernfalls wird null
zurückgegeben.
Beispiele
Dieses Beispiel betrachtet die pendingRemoteDescription
, um festzustellen, ob eine Beschreibungsänderung verarbeitet wird.
const pc = new RTCPeerConnection();
// ...
const sd = pc.pendingRemoteDescription;
if (sd) {
// There's a description change underway!
} else {
// No description change pending
}
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # dom-peerconnection-pendingremotedesc |
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis: Die Ergänzung von pendingRemoteDescription
und currentRemoteDescription
zur WebRTC-Spezifikation ist relativ neu.
In Browsern, die sie nicht unterstützen, ist nur remoteDescription
verfügbar.