HTMLMediaElement: addTextTrack() method
The addTextTrack() method of the HTMLMediaElement interface creates a new TextTrack object and adds it to the media element. It fires an addtrack event on this media element's textTracks. This method can't be used on a TextTrackList interface, only an HTMLMediaElement.
Syntax
js
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)
Parameters
kind-
A string representing the
TextTrack.kindproperty (subtitles,captions,descriptions,chapters, ormetadata). label-
A string representing the
TextTrack.labelproperty. language-
A string representing the
TextTrack.languageproperty.
Return value
The newly created TextTrack object.
Exceptions
None.
Examples
This example adds a new TextTrack with the kind set to "subtitles", and adds a new VTTCue to that.
js
const video = document.querySelector("video");
const newTrack = video.addTextTrack("subtitles");
newTrack.addCue(new VTTCue(3, 6, "Hello world!"));
console.log(newTrack.cues[0].text);
// "Hello world!"