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