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.
js
addEventListener("addtrack", (event) => {});
onaddtrack = (event) => {};
Event type
A MediaStreamTrackEvent. Inherits from Event.
Event properties
Also inherits properties from its parent interface, Event.
MediaStreamTrackEvent.trackRead only-
A
MediaStreamTrackobject 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
| Specification |
|---|
| Media Capture and Streams # event-mediastream-addtrack |
Browser compatibility
BCD tables only load in the browser
See also
- Related events:
removetrack - This event on
AudioTrackListtargets:addtrack - This event on
VideoTrackListtargets:addtrack - Media Capture and Streams API
- WebRTC