MediaStream.getTracks() returns an array of every MediaStreamTrack in the stream’s track set — audio and video alike. Per MDN, kind does not matter; you get the full list.
Pass the required arguments shown below. Check return values and browser support before you rely on the result.
Call stream.getTracks. Start with this line.
mediaStream.getTracks()| Call | What it does |
|---|---|
mediaStream.getTracks() | Primary signature. |
stream.getTracks(...) | Call with the arguments your case needs. |
Built into the browser. Call getTracks(...) on a MediaStream — no import required.
mediaStream.getTracks()This member has no parameters beyond those shown in the signature.
| Return Value | Description |
|---|---|
| * | Array of all MediaStreamTracks (may be empty) |
getTracks()List every track from a canvas capture stream.
const stream = document.createElement("canvas").captureStream();
const tracks = stream.getTracks();
console.log(tracks.length); // 1
console.log(tracks[0].kind); // "video"getTracks(). Returns an array of all tracks.1.kind. The only track is "video".[]No tracks yet — the array is empty, not an error.
const stream = new MediaStream();
const tracks = stream.getTracks();
console.log(tracks.length); // 0
console.log(Array.isArray(tracks)); // truegetTracks(). Track set is empty.0. Safe empty array.forEach without extra checks.Compose two kinds; getTracks() returns both.
const ctx = new AudioContext();
const audioTrack = ctx.createMediaStreamDestination()
.stream.getAudioTracks()[0];
const videoTrack = document.createElement("canvas")
.captureStream().getVideoTracks()[0];
const stream = new MediaStream([audioTrack, videoTrack]);
const kinds = stream.getTracks().map((t) => t.kind);
console.log(stream.getTracks().length); // 2
console.log(kinds.join(",")); // "audio,video"
ctx.close();2; kinds cover audio and video.Full list length equals audio count + video count.
const ctx = new AudioContext();
const stream = new MediaStream([
ctx.createMediaStreamDestination().stream.getAudioTracks()[0],
document.createElement("canvas").captureStream().getVideoTracks()[0]
]);
const all = stream.getTracks().length;
const audio = stream.getAudioTracks().length;
const video = stream.getVideoTracks().length;
console.log(all); // 2
console.log(audio + video); // 2
ctx.close();getTracks(). Full set size.MDN-style cleanup: stop every track in one loop.
const stream = document.createElement("canvas").captureStream();
stream.getTracks().forEach((track) => {
track.stop();
});
console.log(stream.getTracks()[0].readyState); // "ended"
console.log(stream.active); // falsegetTracks() for cleanup.stop() on each. Releases the media source.readyState becomes "ended".MediaStream.getTracks() is Baseline Widely available (MDN: since September 2017). It is part of the Media Capture and Streams specification. It is a browser Web API — not available in Node.js, Bun, or Deno.
Supported across modern Chrome, Firefox, Safari, and Edge for listing every track in a stream.
Bottom line: Browser only — not a Node.js API. Safe for production. Use it whenever you need the full track list or to stop every track.
Filter a stream down to its video tracks only.
10 people found this page helpful