HTMLMediaElement: свойство textTracks

Только для чтения textTracks свойство объекта HTMLMediaElement возвращает объект TextTrackList, перечисляющий все объекты TextTrack, представляющие текстовые дорожки элемента мультимедиа, в том же порядке, что и в списке текстовых дорожек.

Вы можете обнаружить добавление и удаление дорожек в элементе <audio> или <video>, используя события addtrack и removetrack. Однако эти события не отправляются непосредственно элементу мультимедиа. Вместо этого они отправляются объекту списка дорожек объекта HTMLMediaElement, соответствующему типу добавленной дорожки.

Возвращаемый список является динамическим; то есть, по мере добавления и удаления дорожек из элемента мультимедиа, содержимое списка динамически изменяется. После получения ссылки на список вы можете отслеживать изменения, чтобы обнаружить добавление новых текстовых дорожек или удаление существующих.

См. события TextTrackList, чтобы узнать больше о просмотре изменений списка дорожек элемента мультимедиа.

Объект TextTrackList, представляющий список текстовых дорожек, включенных в элемент мультимедиа. К списку дорожек можно получить доступ, используя textTracks[n] для получения n-й текстовой дорожки из списка текстовых дорожек объекта или используя метод textTracks.getTrackById().

Каждая дорожка представлена объектом TextTrack, который предоставляет информацию о дорожке.

Начнём с элемента <video>, имеющего несколько дочерних элементов <track>

<video controls poster="/images/sample.gif">
  <source src="sample.mp4" type="video/mp4" />
  <source src="sample.ogv" type="video/ogv" />
  <track kind="captions" src="sampleCaptions.vtt" srclang="en" />
  <track kind="descriptions" src="sampleDescriptions.vtt" srclang="en" />
  <track kind="chapters" src="sampleChapters.vtt" srclang="en" />
  <track kind="subtitles" src="sampleSubtitles_de.vtt" srclang="de" />
  <track kind="subtitles" src="sampleSubtitles_en.vtt" srclang="en" />
  <track kind="subtitles" src="sampleSubtitles_ja.vtt" srclang="ja" />
  <track kind="subtitles" src="sampleSubtitles_oz.vtt" srclang="oz" />
  <track kind="metadata" src="keyStage1.vtt" srclang="en" label="Key Stage 1" />
  <track kind="metadata" src="keyStage2.vtt" srclang="en" label="Key Stage 2" />
  <track kind="metadata" src="keyStage3.vtt" srclang="en" label="Key Stage 3" />
</video>

Свойство HTMLMediaElement.textTracks возвращает объект textTracksList, с помощью которого можно итерироваться. Здесь мы выводим все свойства каждой английской дорожки в консоль.

const tracks = document.querySelector("video").textTracks;

for (const track of tracks) {
  if (track.language === "en") {
    console.dir(track);
  }
}

• HTMLMediaElement: Интерфейс, используемый для определения свойства HTMLMediaElement.textTracks
• <audio>, <video>
• AudioTrack, AudioTrackList
• VideoTrack, VideoTrackList
• addtrack, change, removetrack: События AudioTrackList
• addtrack, change, removetrack: События VideoTrackList