MediaStream: addtrack event

The addtrack event is fired when a new MediaStreamTrack object has been added to a MediaStream.

This event is not cancelable and does not bubble.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener('addtrack', (event) => { });

onaddtrack = (event) => { };

Event type

An MediaStreamTrackEvent. Inherits from Event.

Event MediaStreamTrackEvent

Event properties

Also inherits properties from its parent interface, Event.

track Read only

A MediaStreamTrack object representing the track which was added to the stream.

Examples

Using addEventListener():

let stream = new MediaStream();

stream.addEventListener('addtrack', (event) => {
  console.log(`New ${event.track.kind} track added`);
});

Using the onaddtrack event handler property:

let stream = new MediaStream();

stream.onaddtrack = (event) => {
  console.log(`New ${event.track.kind} track added`);
};

Specifications

Specification
Media Capture and Streams
# event-mediastream-addtrack

Browser compatibility

BCD tables only load in the browser

See also