VideoTrackList: addtrack event

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

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

onaddtrack = (event) => {};

Event type

A TrackEvent. Inherits from Event.

Event TrackEvent

Event properties

In addition to the properties listed below, properties from the parent interface, Event, are available.

track Read only

The newly-added VideoTrack the event is in reference to.

Examples

Using addEventListener():

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

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

Using the onaddtrack event handler property:

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

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

Specifications

Specification
HTML Standard
# event-media-addtrack
HTML Standard
# handler-tracklist-onaddtrack

Browser compatibility

BCD tables only load in the browser

See also