MediaStream.getTrackById()

The MediaStream.getTrackById() method returns a MediaStreamTrack object representing the track with the specified ID string. If there is no track with the specified ID, this method returns null.

Syntax

JavaScript
var track = MediaStream.getTrackById(id);

Parameters

id
A DOMString which identifies the track to be returned.

Return value

If a track is found for which MediaStreamTrack.id matches the specified id string, that MediaStreamTrack object is returned. Otherwise, the returned value is null.

Example

This example activates a commentary track on a video by ducking the audio level of the main audio track to 50%, then enabling the commentary track.

JavaScript
stream.getTrackById("primary-audio-track").applyConstraints({ volume: 0.5 });
stream.getTrackById("commentary-track").enabled = true;

Specifications

Specification Status Comment
Media Capture and Streams
The definition of 'getTrackById()' in that specification.
Editor's Draft Initial specification.

Browser compatibility

?
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support ? 49 (49) No support ? ?
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? ? 49.0 (49) No support ? ?

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/mediastream/gettrackbyid

getTrackById Media MediaStream MediaStream API Method Reference WebRTC