大网数据广告活动
Web 标准与前端开发

RTCPeerConnection.connectionState

· 52CE 我爱测

`connectionState`** 只读属性表示了当前所有被使用的 ICE 连接的状态,其返回值为以下字符串之一:`new`、`connecting`、`connected`、`disconnected`、`failed` 或 `closed`。

WebRTC

connectionState 只读属性表示了当前所有被使用的 ICE 连接的状态,其返回值为以下字符串之一:new、connecting、connected、disconnected、failed 或 closed。

该状态本质上表示所有使用的 ICE 连接(类型为 RTCIceTransport 或 RTCDtlsTransport)的聚合状态。

当属性值变化时,一个 RTCPeerConnection.connectionstatechange_event 事件将被发送给 RTCPeerConnection 对象实例。

语法

var connectionState = RTCPeerConnection.connectionState;

返回值

一个用于表示当前连接状态的字符串,为以下列出的值之一:

  • new
    • : 表示至少有一个 ICE 连接(RTCIceTransport 或 RTCDtlsTransport 对象)处于 new 状态,并且没有连接处于以下状态: connecting、checking、failed、disconnected,或者这些连接都处于 closed 状态。
  • connecting
    • : 表示至少有一个 ICE 连接处于正在建立连接的状态;也就是说,它们的 RTCPeerConnection.iceConnectionState 值为 checking 或 connected,并且没有连接处于 failed 状态。
  • connected
    • : 表示每一个 ICE 连接要么正在使用(connected 或 completed 状态),要么已被关闭(closed 状态);并且,至少有一个连接处于 connected 或 completed 状态。
  • disconnected
    • : 表示至少有一个 ICE 连接处于 disconnected 状态,并且没有连接处于 failed、connecting 或 checking 状态。
  • failed
    • : 表示至少有一个 ICE 连接处于 failed 的状态。
  • closed
    • : 表示 RTCPeerConnection 已关闭。

示例

var pc = new RTCPeerConnection(configuration);

/* ... */

var connectionState = pc.connectionState;

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。