W3cubDocs

/Web APIs

TextTrack: cues property

The cues read-only property of the TextTrack interface returns a TextTrackCueList object containing all of the track's cues.

Value

Examples

In the following example two cues are added to a video text track using addCue(). The value of cues is printed to the console. The returned TextTrackCueList object contains the two cues.

js

let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";
track.addCue(new VTTCue(0, 0.9, "Hildy!"));
track.addCue(new VTTCue(1, 1.4, "How are you?"));
console.log(track.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
cues 23 12
31Starting in Firefox 69, cues are no longer incorrectly loaded when the TextTrack's mode is disabled; if that's the case, the returned list is empty.
10 ≤12.1 6 4.4 25 31 ≤12.1 7 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/TextTrack/cues