new VideoTrack(optionsopt)

[tracks/video-track.js](https://docs.videojs.com/tracks_video-track.js.html), [line 11](https://docs.videojs.com/tracks_video-track.js.html#line11)

Create an instance of this class.

Parameters:

See:

• Spec

Extends

• Track

Members

readonly id :string

[tracks/track.js](https://docs.videojs.com/tracks_track.js.html), [line 50](https://docs.videojs.com/tracks_track.js.html#line50)

The id of this track. Cannot be changed after creation.

• Overrides:

  • Track#id

readonly kind :string

[tracks/track.js](https://docs.videojs.com/tracks_track.js.html), [line 59](https://docs.videojs.com/tracks_track.js.html#line59)

The kind of track that this is. Cannot be changed after creation.

• Overrides:

  • Track#kind

label :string

[tracks/track.js](https://docs.videojs.com/tracks_track.js.html), [line 87](https://docs.videojs.com/tracks_track.js.html#line87)

The label of this track. Cannot be changed after creation.

• Overrides:

  • Track#label

Fires:

• Track#event:labelchange

readonly language :string

[tracks/track.js](https://docs.videojs.com/tracks_track.js.html), [line 68](https://docs.videojs.com/tracks_track.js.html#line68)

The two letter language code for this track. Cannot be changed after creation.

• Overrides:

  • Track#language

selected :boolean

[tracks/video-track.js](https://docs.videojs.com/tracks_video-track.js.html), [line 43](https://docs.videojs.com/tracks_video-track.js.html#line43)

If this VideoTrack is selected or not. When setting this will fire VideoTrack#selectedchange if the state of selected changed.

Fires:

• VideoTrack#event:selectedchange

Methods

addEventListener()

[event-target.js](https://docs.videojs.com/event-target.js.html), [line 75](https://docs.videojs.com/event-target.js.html#line75)

An alias of EventTarget#on. Allows EventTarget to mimic the standard DOM API.

• Overrides:

  • Track#addEventListener

  See:

  • EventTarget#on

dispatchEvent()

[event-target.js](https://docs.videojs.com/event-target.js.html), [line 175](https://docs.videojs.com/event-target.js.html#line175)

An alias of EventTarget#trigger. Allows EventTarget to mimic the standard DOM API.

• Overrides:

  • Track#dispatchEvent

  See:

  • EventTarget#trigger

off(type, fn)

[event-target.js](https://docs.videojs.com/event-target.js.html), [line 88](https://docs.videojs.com/event-target.js.html#line88)

Removes an event listener for a specific event from an instance of EventTarget. This makes it so that the event listener will no longer get called when the named event happens.

Parameters:

• Overrides:

  • Track#off

on(type, fn)

[event-target.js](https://docs.videojs.com/event-target.js.html), [line 58](https://docs.videojs.com/event-target.js.html#line58)

Adds an event listener to an instance of an EventTarget. An event listener is a function that will get called when an event with a certain name gets triggered.

Parameters:

• Overrides:

  • Track#on

one(type, fn)

[event-target.js](https://docs.videojs.com/event-target.js.html), [line 112](https://docs.videojs.com/event-target.js.html#line112)

This function will add an event listener that gets triggered only once. After the first trigger it will get removed. This is like adding an event listener with EventTarget#on that calls EventTarget#off on itself.

Parameters:

• Overrides:

  • Track#one

removeEventListener()

[event-target.js](https://docs.videojs.com/event-target.js.html), [line 99](https://docs.videojs.com/event-target.js.html#line99)

An alias of EventTarget#off. Allows EventTarget to mimic the standard DOM API.

• Overrides:

  • Track#removeEventListener

  See:

  • EventTarget#off

trigger(event)

[event-target.js](https://docs.videojs.com/event-target.js.html), [line 148](https://docs.videojs.com/event-target.js.html#line148)

This function causes an event to happen. This will then cause any event listeners that are waiting for that event, to get called. If there are no event listeners for an event then nothing will happen.

If the name of the Event that is being triggered is in EventTarget.allowedEvents_. Trigger will also call the on + uppercaseEventName function.

Example: ‘click’ is in EventTarget.allowedEvents_, so, trigger will attempt to call onClick if it exists.

Parameters:

• Overrides:

  • Track#trigger

Type Definitions

Kind

[tracks/track-enums.js](https://docs.videojs.com/tracks_track-enums.js.html), [line 5](https://docs.videojs.com/tracks_track-enums.js.html#line5)

All possible VideoTrackKinds

• See:

  • https://html.spec.whatwg.org/multipage/embedded-content.html#dom-videotrack-kind

Events

labelchange

[tracks/track.js](https://docs.videojs.com/tracks_track.js.html), [line 103](https://docs.videojs.com/tracks_track.js.html#line103)

An event that fires when label changes on this track.

Note: This is not part of the spec!

Type:

• EventTarget~Event

• Overrides:

  • Track#event:labelchange

selectedchange

[tracks/video-track.js](https://docs.videojs.com/tracks_video-track.js.html), [line 63](https://docs.videojs.com/tracks_video-track.js.html#line63)

An event that fires when selected changes on this track. This allows the VideoTrackList that holds this track to act accordingly.

Note: This is not part of the spec! Native tracks will do this internally without an event.

Type:

• EventTarget~Event