TextTrackList: addtrack event

Baseline
Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The addtrack event is fired when a track is added to a TextTrackList.

Syntax

Use the event name in addEventListener():

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

Alternatively, assign to the event handler property of the interface:

js
onaddtrack = (event) => { }

Event type

A TrackEvent. Inherits from Event.

Event TrackEvent

Examples

Using addEventListener():

js
const mediaElement = document.querySelector("video, audio");

mediaElement.textTracks.addEventListener("addtrack", (event) => {
  console.log(`Text track: ${event.track.label} added`);
});

Using the onaddtrack event handler property (but note that this replaces other event listeners added using onaddtrack, if any):

js
const mediaElement = document.querySelector("video, audio");

mediaElement.textTracks.onaddtrack = (event) => {
  console.log(`Text track: ${event.track.label} added`);
};

Specifications

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

Browser compatibility

See also