TextTrackCueList

The TextTrackCueList array-like object represents a dynamically updating list of TextTrackCue objects.

This interface has no constructor. Retrieve an instance of this object with TextTrack.cues which returns all of the cues in a TextTrack object.

Instance properties

TextTrackCueList.length Read only: An unsigned long that is the number of cues in the list.

Instance methods

TextTrackCueList.getCueById(): Returns the first TextTrackCue object with the identifier passed to it.

Examples

The HTMLMediaElement.textTracks property returns a TextTrackList object listing all of the TextTrack objects, one for each text track linked to the media. The TextTrack.cues property then returns a TextTrackCueList containing the cues for that particular track.

js

const video = document.getElementById("video");
video.onplay = () => {
  console.log(video.textTracks[0].cues);
};

Specifications

Specification
HTML Standard # texttrackcuelist

Browser compatibility

BCD tables only load in the browser