W3cubDocs

/Web APIs

TextTrack: language property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

The language read-only property of the TextTrack interface returns the language of the text track.

This uses the same values as the HTML lang attribute. These values are documented in RFC 5646: Tags for Identifying Languages (also known as BCP 47).

Value

A string containing a language identifier. For example, "en-US" for United States English or "pt-BR" for Brazilian Portuguese.

Examples

In the following example the value of language is printed to the console.

let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en-US");
track.mode = "showing";
console.log(track.language);

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
language 23 12 31 ≤12.1 6 25 31 ≤12.1 7 1.5 4.4 7

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/TextTrack/language