dom / latest / texttrack / cues.html /

TextTrack.cues

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

Value

A TextTrackCueList object.

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.

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

No specification found

No specification data found for api.TextTrack.cues.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

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
31
Starting 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–2021 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