RTCDataChannel: id-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 RTCDataChannel-Eigenschaft id gibt eine ID-Nummer (zwischen 0 und 65.534) zurück, die das RTCDataChannel eindeutig identifiziert. Diese ID wird zum Zeitpunkt der Erstellung des Datenkanals festgelegt, entweder durch den User Agent (wenn RTCDataChannel.negotiated false ist) oder durch das Webseiten- oder App-Skript (wenn negotiated true ist).

Jede RTCPeerConnection kann theoretisch bis zu 65.534 Datenkanäle haben, obwohl das tatsächliche Maximum von Browser zu Browser variieren kann.

Wert

Ein unsigned short-Wert (also eine ganze Zahl zwischen 0 und 65.535), der den Datenkanal eindeutig identifiziert.

Während die label-Eigenschaft nicht eindeutig sein muss, ist diese ID-Nummer unter allen Datenkanälen garantiert eindeutig. Darüber hinaus verwenden bekannte Implementierungen von WebRTC die gleiche ID auf beiden Peers. Eine eindeutige ID erleichtert es Ihrem Code, eigene out-of-band-Datenkanal-bezogene Signalisierungen durchzuführen.

Dies kann auch für Protokollierungs- und Debugging-Zwecke nützlich sein.

Beispiel

js
const pc = new RTCPeerConnection();
const dc = pc.createDataChannel("my channel");

console.log(`Channel id: ${dc.id}`);

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcdatachannel-id

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch