RTCDataChannelEvent: RTCDataChannelEvent() constructor
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
The RTCDataChannelEvent()
constructor
creates a new RTCDataChannelEvent
object.
Note: You will rarely if ever construct an RTCDataChannelEvent
by hand; these
events are normally created and sent by the WebRTC layer itself.
Syntax
new RTCDataChannelEvent(type, options)
Parameters
type
-
A string with the name of the event. It is case-sensitive and browsers always set it to
datachannel
. options
-
An object that, in addition of the properties defined in
Event()
, can have the following properties:channel
-
A
RTCDataChannel
, representing the data channel being associated with the event.
Return value
A new RTCDataChannelEvent
object configured as specified.
Example
In this example, a new datachannel
event is created. dc
is a
data channel which already exists.
const event = new RTCDataChannelEvent("datachannel", { channel: dc });
Specifications
Specification |
---|
WebRTC: Real-Time Communication in Browsers # dom-rtcdatachannelevent-constructor |
Browser compatibility
BCD tables only load in the browser