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.
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 |