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.track
Read only-
A
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
Specification |
---|
Media Capture and Streams # event-mediastream-addtrack |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
addtrack event |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
See also
- Related events:
removetrack
- This event on
AudioTrackList
targets:addtrack
- This event on
VideoTrackList
targets:addtrack
- Media Capture and Streams API
- WebRTC