RTCDataChannel: id-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 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
const pc = new RTCPeerConnection();
const dc = pc.createDataChannel("my channel");
console.log(`Channel id: ${dc.id}`);
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcdatachannel-id |