This feature is not Baseline because it does not work in some of the most widely-used browsers.
Note: This feature is available in Dedicated Web Workers.
The sourceclose event is fired when a MediaSource object's readyState changes to "closed". This indicates that the MediaSource has been detached from the media element.
Use the event name in methods like addEventListener(), or set an event handler property.
addEventListener("sourceclose", (event) => { })
onsourceclose = (event) => { }
A generic Event.
This example demonstrates detaching a media element from a MediaSource and handling the sourceclose event for proper resource management. The code sets up a MediaSource, attaches it to a video element, and listens for the sourceclose event. When the event fires, it performs cleanup tasks (revokeObjectURL).
const video = document.getElementById("myVideo");
const mediaSource = new MediaSource();
video.src = URL.createObjectURL(mediaSource);
mediaSource.addEventListener("sourceopen", (event) => {
const sourceBuffer = mediaSource.addSourceBuffer(
'video/mp4; codecs="avc1.42E01E"',
);
fetch("video-data.mp4")
.then((response) => response.arrayBuffer())
.then((data) => {
sourceBuffer.appendBuffer(data);
});
});
function detachMediaSource() {
video.src = null; // Detach the MediaSource
}
mediaSource.addEventListener("sourceclose", (event) => {
console.log("MediaSource sourceclose:", event);
// Perform cleanup tasks here, e.g., release resources, update UI
URL.revokeObjectURL(video.src); // Clean up the object URL
});
// Call detachMediaSource() when appropriate, e.g., on a button click
document
.getElementById("detachButton")
.addEventListener("click", detachMediaSource);
| Specification |
|---|
| Media Source Extensions™> # dfn-sourceclose> |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | WebView on iOS | |
sourceclose_event |
5331–53Theonsourceclose event handler property is not supported. |
1712–17Theonsourceclose event handler property is not supported. |
8742–87Theonsourceclose event handler property is not supported. |
4018–40Theonsourceclose event handler property is not supported. |
10.18–10.1Theonsourceclose event handler property is not supported. |
5331–53Theonsourceclose event handler property is not supported. |
8741–87Theonsourceclose event handler property is not supported. |
4118–41Theonsourceclose event handler property is not supported. |
13Exposed in Mobile Safari on iPad but not on iPhone. |
6.02.0–6.0Theonsourceclose event handler property is not supported. |
534.4.3–53Theonsourceclose event handler property is not supported. |
No |
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaSource/sourceclose_event