W3cubDocs

/Web APIs

TextTrack: kind property

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.

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 example VTTCue.

"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 example VTTCue.

"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

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