The kind
read-only property of the TextTrack
interface returns the kind of text track this object represents. This decides how the track will be handled by a user agent.
On this page
TextTrack: kind property
Value
A string. One of:
-
"subtitles"
-
The cues are overlaid on the video. Positioning of the cues is controlled using the properties of an object that inherits from
TextTrackCue
, for exampleVTTCue
. -
"captions"
-
The cues are overlaid on the video. Positioning of the cues is controlled using the properties of an object that inherits from
TextTrackCue
, for exampleVTTCue
. -
"descriptions"
-
The cues are made available in a non-visual fashion.
-
"chapters"
-
The user agent will make available a mechanism to navigate by selecting a cue.
-
"metadata"
-
Additional data related to the media data, which could be used for interactive views.
Examples
In the following example the value of kind
is printed to the console.
js
let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";
console.log(track.kind);
Specifications
Specification |
---|
HTML Standard # dom-texttrack-kind-dev |
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 | |
kind |
23 | 12 | 31 | 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/kind