RTCTrackEvent: RTCTrackEvent() 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 RTCTrackEvent() constructor creates and returns a new RTCTrackEvent object, configured to describe the track which has been added to the RTCPeerConnection.

In general, you won't need to use this constructor, as RTCTrackEvent objects are created by WebRTC and delivered to your RTCPeerConnector's ontrack event handler as appropriate.

Syntax

js
new RTCTrackEvent(type, options)

Parameters

type

A string with the name of the event. It is case-sensitive and browsers always set it to track.

options

An object that, in addition of the properties defined in Event(), can have the following properties:

receiver

The RTCRtpReceiver which is being used to receive the track's media.

streams Optional

An array of MediaStream objects representing each of the streams that comprise the event's corresponding track. It defaults to an empty array.

track

The MediaStreamTrack the event is associated with.

transceiver

The RTCRtpTransceiver associated with the event.

Return value

A new RTCTrackEvent describing a track which has been added to the RTCPeerConnection.

Specifications

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtctrackevent-constructor

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
RTCTrackEvent() constructor

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support