W3cubDocs

/Web APIs

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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
TextTrackCueList 23 12 31 10 ≤12.1 6 4.4 25 31 ≤12.1 6 1.5
getCueById 23 12 31 10 ≤12.1 6 4.4 25 31 ≤12.1 6 1.5
length 23 12 31 10 ≤12.1 6 4.4 25 31 ≤12.1 6 1.5

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/TextTrackCueList