TextTrackList: change 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 change event is fired when a text track is made active or inactive, or a TextTrackList is otherwise changed.

Syntax

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

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

onchange = (event) => {};

Event type

A generic Event with no added properties.

Examples

Using addEventListener():

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

Using the onchange event handler property:

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

Specifications

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

Browser compatibility

BCD tables only load in the browser

See also