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.

js
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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
label

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch