RTCDataChannel: label 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

只讀的 RTCDataChannel 屬性 label 返回一個字串,其中包含描述資料通道的名稱。這些標籤不要求唯一。

您可以隨意使用此標籤;您可以將其用於識別所有用於相同目的的通道,方法是為它們提供相同的名稱。或者,您可以為每個通道提供一個唯一的標籤用於跟蹤目的。這完全取決於您在構建網站或應用程式時所做的設計決策。

可以透過 id 屬性找到唯一的 ID。

注意: 資料通道的標籤在建立通道時透過呼叫 RTCPeerConnection.createDataChannel() 來設定。之後無法更改。

網站或應用在建立資料通道時分配的字串識別符號,如呼叫 RTCPeerConnection.createDataChannel() 建立通道時所指定的那樣。

示例

此示例在 RTCPeerConnection 上建立一個數據通道,然後在稍後將 UI 元素的內容設定為顯示通道的名稱。

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,
  }),
);

規範

規範
WebRTC:瀏覽器中的即時通訊
# dom-datachannel-label

瀏覽器相容性

另見