Repository navigation
Expand file tree
/
Copy pathindex.md
More file actions
60 lines (46 loc) · 1.55 KB
/
Copy pathindex.md
File metadata and controls
60 lines (46 loc) · 1.55 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
---
title: "VideoTrack: label property"
short-title: label
slug: Web/API/VideoTrack/label
page-type: web-api-instance-property
browser-compat: api.VideoTrack.label
---
{{APIRef("HTML DOM")}}
The read-only **{{domxref("VideoTrack")}}**
property **`label`** returns a string specifying the video
track's human-readable label, if one is available; otherwise, it returns an empty
string.
## Value
A string specifying the track's human-readable label, if one is
available in the track metadata. Otherwise, an empty string (`""`) is
returned.
For example, a track whose {{domxref("VideoTrack.kind", "kind")}} is
`"sign"` might have a `label` such as
`"A sign-language interpretation."`.
## Examples
This example returns an array of track kinds and labels for potential use in a user
interface to select video tracks for a specified media element. The list is filtered to
only allow certain track kinds through.
```js
function getTrackList(el) {
const trackList = [];
const wantedKinds = ["main", "alternative", "commentary"];
el.videoTracks.forEach((track) => {
if (wantedKinds.includes(track.kind)) {
trackList.push({
id: track.id,
kind: track.kind,
label: track.label,
});
}
});
return trackList;
}
```
The resulting `trackList` contains an array of video tracks whose
`kind` is one of those in the array `wantedKinds`, with each entry
providing the track's {{domxref("VideoTrack.id", "id")}}, {{domxref("VideoTrack.kind", "kind")}}, and `label`.
## Specifications
{{Specifications}}
## Browser compatibility
{{Compat}}