RTCPeerConnection.iceGatheringState

基线广泛可用

自 2017年9月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

只读属性 RTCPeerConnection.iceGatheringState 返回一个描述连接的 ICE 收集状态的字符串。比如当 ICE 候选收集完成的时候，你可以通过该属性的变化侦测到。

通过监听 icegatheringstatechange 类型的事件，你可以侦测到该属性的变化。

值

可能的值是：

new: 对等连接刚刚创建，尚未进行任何网络连接。
gathering: ICE 代理正在收集候选的连接。
complete: ICE 代理完成了候选的收集。如果发生了需要收集的新候选，例如一个新接口的增加或者一个新的 ICE 服务器的增加，状态将恢复到 gathering，并去收集这些候选。

const pc = new RTCPeerConnection();
const state = pc.iceGatheringState;

规范
WebRTC: Real-Time Communication in Browsers # dom-peerconnection-ice-gathering-state

此页面最后更新于 2022年12月6日，由 MDN 贡献者更新。