TextTrackCueList.getCueById()
The getCueById()
method of the TextTrackCueList
interface returns the first VTTCue
in the list represented by the TextTrackCueList
object whose identifier matches the value of id
.
Syntax
var cue = TextTrackCueList.getCueById(id);
Parameters
- id
-
A
DOMString
which is an identifier for the cue.
Return value
A VTTCue
object.
Examples
The TextTrack.cues
property returns a TextTrackCueList
containing the current cues for that particular track. Calling cues.getCueById("second")
returns the VTTCue
with an ID of "second".
WEBVTT first 00:00:00.000 --> 00:00:00.999 line:80% Hildy! second 00:00:01.000 --> 00:00:01.499 line:80% How are you?
let video = document.getElementById("video");
video.onplay = function () {
console.log(video.textTracks[0].cues.getCueById("second")) // a VTTCue object;
}
Specifications
Specification |
---|
HTML Standard # dom-texttrackcuelist-getcuebyid |
Browser compatibility
BCD tables only load in the browser