TextTrackList: getTrackById() method

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 TextTrackList method getTrackById() returns the first TextTrack object from the track list whose id matches the specified string. This lets you find a specified track if you know its ID string.

Syntax

js
getTrackById(id)

Parameters

id

A string indicating the ID of the track to locate within the track list.

Return value

A TextTrack object indicating the first track found within the TextTrackList whose id matches the specified string. If no match is found, this method returns null.

The tracks are searched in their natural order; that is, in the order defined by the media resource itself, or, if the resource doesn't define an order, the relative order in which the tracks are declared by the media resource.

Specifications

Specification
HTML Standard
# dom-texttracklist-gettrackbyid-dev

Browser compatibility

BCD tables only load in the browser