Back to Content

MediaStream: addtrack event

files/en-us/web/api/mediastream/addtrack_event/index.md

latest1.8 KB
Original Source

{{APIRef("Media Capture and Streams")}}

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 {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

js-nolint
addEventListener("addtrack", (event) => { })

onaddtrack = (event) => { }

Event type

A {{domxref("MediaStreamTrackEvent")}}. Inherits from {{domxref("Event")}}.

{{InheritanceDiagram("MediaStreamTrackEvent")}}

Event properties

Also inherits properties from its parent interface, {{domxref("Event")}}.

  • {{domxref("MediaStreamTrackEvent.track")}} {{ReadOnlyInline}}
    • : A {{domxref("MediaStreamTrack")}} object representing the track which was added to the stream.

Examples

Using addEventListener():

js
const stream = new MediaStream();

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

Using the onaddtrack event handler property:

js
const stream = new MediaStream();

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also