RTCDataChannel: label-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 label
gibt einen Zeichenfolgenwert zurück, der einen Namen beschreibt, der den Datenkanal kennzeichnet. Diese Bezeichnungen müssen nicht eindeutig sein.
Sie können die Bezeichnung nach Belieben verwenden: Sie könnten sie verwenden, um alle Kanäle zu identifizieren, die für denselben Zweck verwendet werden, indem Sie ihnen allen denselben Namen geben. Oder Sie könnten jedem Kanal eine eindeutige Bezeichnung zuweisen, um sie nachzuverfolgen. Dies liegt ganz in den Designentscheidungen, die beim Erstellen Ihrer Website oder App getroffen wurden.
Eine eindeutige ID finden Sie in der id
-Eigenschaft.
Hinweis: Die Bezeichnung eines Datenkanals wird festgelegt, wenn der Kanal durch Aufruf von RTCPeerConnection.createDataChannel()
erstellt wird. Sie kann danach nicht mehr geändert werden.
Wert
Ein von der Website oder App zugewiesener Zeichenfolgen-Identifier, der beim Erstellen des Datenkanals festgelegt wurde, wie angegeben, als RTCPeerConnection.createDataChannel()
aufgerufen wurde, um den Kanal zu erstellen.
Beispiel
Dieses Beispiel erstellt einen Datenkanal auf einer RTCPeerConnection
und setzt später den Inhalt eines UI-Elements, um den Namen des Kanals anzuzeigen.
const pc = new RTCPeerConnection();
const dc = pc.createDataChannel("my channel");
// …
document.getElementById("channel-name").appendChild(
Object.assign(document.createElement("span"), {
className: "channelName",
textContent: dc.label,
}),
);
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # dom-datachannel-label |
Browser-Kompatibilität
BCD tables only load in the browser