The track
event is sent to the ontrack
event handler on RTCPeerConnection
s after a new track has been added to an RTCRtpReceiver
which is part of the connection.
Bubbles | Yes |
---|---|
Cancelable | No |
Interface | RTCTrackEvent |
Event handler property | ontrack |
By the time this event is delivered, the new track has been fully added to the peer connection. See Track event types in RTCTrackEvent for details.
Examples
This example shows code that creates a new RTCPeerConnection
, then adds a new track
event handler.
pc = new RTCPeerConnection({ iceServers: [ { urls: "turn:fake.turnserver.url", username: "someusername", credential: "somepassword" } ] }); pc.addEventListener("track", e => { videoElement.srcObject = e.streams[0]; hangupButton.disabled = false; }, false);
The event handler assigns the new track's first stream to an existing <video>
element, identified using the variable videoElement
.
You can also assign the event handler function to the ontrack
property, rather than use addEventListener()
.
pc.ontrack = e => { videoElement.srcObject = e.streams[0]; hangupButton.disabled = false; return false; }
Specifications
Specification | Status | Comment |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'track' in that specification. |
Candidate Recommendation | Initial specification. |
Browser compatibility
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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
track event | Chrome Full support 64 | Edge Full support ≤18 | Firefox Full support 22 | IE No support No | Opera Full support 43 | Safari Full support 11 | WebView Android Full support 64 | Chrome Android Full support 64 | Firefox Android Full support 44 | Opera Android Full support 43 | Safari iOS ? | Samsung Internet Android Full support 6.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown