TextTrackList: change event

The change event is fired when a text track is made active or inactive, or a TextTrackList is otherwise changed.


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

addEventListener("change", (event) => {});

onchange = (event) => {};

Event type

A generic Event with no added properties.


Using addEventListener():

const mediaElement = document.querySelectorAll("video, audio")[0];
mediaElement.textTracks.addEventListener("change", (event) => {
  console.log(`'${event.type}' event fired`);

Using the onchange event handler property:

const mediaElement = document.querySelector("video, audio");
mediaElement.textTracks.onchange = (event) => {
  console.log(`'${event.type}' event fired`);


HTML Standard
# event-media-change
HTML Standard
# handler-tracklist-onchange

Browser compatibility

BCD tables only load in the browser

See also