VideoTrackList: change event

The change event is fired when a video track is made active or inactive, for example by changing the track's selected property.

Bubbles No
Cancelable No
Interface Event
Event handler property onchange

Examples

Using addEventListener():

const videoElement = document.querySelector('video');
videoElement.videoTracks.addEventListener('change', (event) => {
    console.log(`'${event.type}' event fired`);
});

// changing the value of `selected` will trigger the `change` event
const toggleTrackButton = document.querySelector('.toggle-track');
toggleTrackButton.addEventListener('click', () => {
  const track = videoElement.videoTracks[0];
  track.selected = !track.selected;
});

Using the onchange event handler property:

const videoElement = document.querySelector('video');
videoElement.videoTracks.onchange = (event) => {
    console.log(`'${event.type}' event fired`);
};

// changing the value of `selected` will trigger the `change` event
const toggleTrackButton = document.querySelector('.toggle-track');
toggleTrackButton.addEventListener('click', () => {
  const track = videoElement.videoTracks[0];
  track.selected = !track.selected;
});

Specifications

Specification Status
HTML Living Standard
The definition of 'change' in that specification.
Living Standard

Browser compatibility

BCD tables only load in the browser

See also