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

浏览器兼容性

另见