W3cubDocs

/Web APIs

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 ⁨October 2018⁩.

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.

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

onchange = (event) => { }

Event type

A generic Event with no added properties.

Examples

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`);
};

Specifications

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

Browser compatibility