TextTrackCueList
Baseline Widely available
The TextTrackCueList
interface of the WebVTT API is an array-like object that represents a dynamically updating list of TextTrackCue
objects.
An instance of this type is obtained from TextTrack.cues
in order to get all the cues in the TextTrack
object. This interface has no constructor.
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 |
Opera |
Safari |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
WebView Android |
TextTrackCueList |
23 |
12 |
31 |
≤12.1 |
6 |
25 |
31 |
≤12.1 |
6 |
1.5 |
4.4 |
getCueById |
23 |
12 |
31 |
≤12.1 |
6 |
25 |
31 |
≤12.1 |
6 |
1.5 |
4.4 |
length |
23 |
12 |
31 |
≤12.1 |
6 |
25 |
31 |
≤12.1 |
6 |
1.5 |
4.4 |