RTCPeerConnectionIceErrorEvent: address 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

RTCPeerConnectionIceErrorEventaddress 属性是一个字符串,表示在协商期间用于与 STUNTURN 服务器通信的本地 IP 地址。发生的错误涉及此地址。

一个字符串,指定发生错误时正在进行协商的 ICE 服务器的网络连接的本地 IP 地址。此地址标识了本地设备上正在使用的网络接口,该接口正用于尝试建立与远程对等体的连接。

这在多宿主系统(具有多个网络连接的设备)上可能很有用,可以确定正在使用哪个网络接口。例如,在手机上,通常至少有两个可用的网络接口:蜂窝网络连接和 Wi-Fi 连接。

如果本地 IP 地址未作为本地候选者的一部分公开,则 address 的值为 null

示例

此示例创建了一个 icecandidateerror 事件的处理程序,该处理程序会创建人类可读的消息,描述连接的本地网络接口以及用于尝试打开连接的 ICE 服务器,然后调用一个函数来显示这些消息以及事件的 errorText 属性的内容。

js
pc.addEventListener("icecandidateerror", (event) => {
  let networkInfo = `[Local interface: ${event.address}:${event.port}`;
  let iceServerInfo = `[ICE server: ${event.url}`;

  showMessage(errorText, iceServerInfo, networkInfo);
});

规范

规范
WebRTC:浏览器中的实时通信
# dom-rtcpeerconnectioniceerrorevent-address

浏览器兼容性