RTCPeerConnection: icecandidateerror event

在此页

描述
范例
规范
浏览器兼容性
相关话题

WebRTC API event icecandidateerror is sent to an RTCPeerConnection if an error occurs while performing ICE negotiations through a STUN or TURN server. The event object is of type RTCPeerConnectionIceErrorEvent , and contains information describing the error in some amount of detail.

冒泡	No
可取消	No
接口	`RTCPeerConnectionIceErrorEvent`
事件处理程序特性	`RTCPeerConnection.onicecandidateerror`

描述

The error object's errorCode property is one of the numeric STUN error codes. There is one additional, WebRTC-specific, error which lies outside the valid STUN error code range: 701. Error 701 indicates that none of the ICE candidates were able to successfully make contact with the STUN or TURN server.

The 701 error is fired only once per server URL from the list of available STUN or TURN servers provided when creating the RTCPeerConnection . These errors occur only when the connection's ICE gathering state is gathering .

范例

The following example establishes a handler for icecandidateerror s that occur on the RTCPeerConnection pc . This handler looks specifically for 701 errors that indicate that candidates couldn't reach the STUN or TURN server.

When this happens, the server URL and the error message are passed to a function called reportConnectFail() to log or output the connection failure.

pc.addEventListener("icecandidateerror", (event) => {
  if (event.errorCode === 701) {
    reportConnectFail(event.url, event.errorText);
  }
});

Note that if multiple STUN and/or TURN servers are provided when creating the connection, this error may happen more than once, if more than one of those servers fails. Each provided server is tried until a connection is established.

规范

规范	状态	注释
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'icecandidateerror' in that specification.	候选推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

No compatibility data found. Please contribute data for "api.RTCPeerConnection.icecandidateerror_event" (depth: 1) to the MDN 兼容性数据存储库 .

元数据

最后修改： Aug 17, 2020

在此页

描述

范例

规范

浏览器兼容性

相关话题