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