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.

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

Siehe auch