VideoTrackList: addtrack event

{{APIRef("HTML DOM")}} 

The addtrack event is fired when a video track is added to a VideoTrackList.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}} , or set an event handler property.

addEventListener("addtrack", (event) => { })

onaddtrack = (event) => { }

Event type

A {{domxref("TrackEvent")}} . Inherits from {{domxref("Event")}} .

{{InheritanceDiagram("TrackEvent")}} 

Event properties

In addition to the properties listed below, properties from the parent interface, {{domxref("Event")}} , are available.

• {{domxref("TrackEvent.track", "track")}}  {{ReadOnlyInline}} 
  • : The newly-added {{domxref("VideoTrack")}}  the event is in reference to.

Examples

Using addEventListener():

const videoElement = document.querySelector("video");

videoElement.videoTracks.addEventListener("addtrack", (event) => {
  console.log(`Video track: ${event.track.label} added`);
});

Using the onaddtrack event handler property:

const videoElement = document.querySelector("video");

videoElement.videoTracks.onaddtrack = (event) => {
  console.log(`Video track: ${event.track.label} added`);
};

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}} 

See also

• Related events: removetrack, change
• This event on AudioTrackList targets: addtrack
• This event on MediaStream targets: addtrack
• Media Capture and Streams API
• WebRTC