This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The RTCPeerConnectionIceEvent()
constructor creates a new RTCPeerConnectionIceEvent
.
Syntax
var event = new RTCPeerConnectionIceEvent(type, options);
Parameters
type
- Is a
DOMString
containing the name of the event, like"icecandidate"
. options
- A dictionary of type
RTCPeerConnectionInit
, which may contain one or more of the following fields:"candidate"
(optional, default isnull
): ARTCIceCandidate
representing the ICE candidate being concerned by the event. Ifnull
, the event indicates the end of candidate gathering."url"
(optional, default isnull
): The URL of the STUN or TURN server which was used to gather the candidate. If the candidate was not gathered by a STUN or TURN server, this value must benull
."bubbles"
(optional, default isfalse
): Inherited fromEventInit()
, this Boolean option indicates whether or not the event must bubble."cancelable"
(optional, default isfalse
, inherited fromEventInit()
, this Boolean indicates whether or not the event can be canceled.
Return value
A newly-created RTCPeerConnectionIceEvent
, configured as specified in the provided options.
Specifications
Specification | Status | Comment |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCPeerConnectionIceEvent()' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 56[1] | (Yes) | No support | (Yes) | ? |
Feature | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | 56[1] | 56[1] | ? | No support | ? | ? |
Only the candidate
option is supported.
See also
- WebRTC
- Its usual target:
RTCPeerConnection
.