The MediaRecorder.stop() method (part of the MediaStream Recording API) is used to stop media capture.
When the stop() method is invoked, the UA queues a task that runs the following steps:
- If
MediaRecorder.state is "inactive", raise a DOM InvalidState error and terminate these steps. If the MediaRecorder.state is not "inactive", continue on to the next step.
- Set the
MediaRecorder.state to "inactive" and stop capturing media.
- Raise a
dataavailable event containing the Blob of data that has been gathered.
- Raise a
stop event.
Syntax
Parameters
Return value
Errors
An InvalidState error is raised if the stop() method is called while the MediaRecorder object's MediaRecorder.state is "inactive" — it makes no sense to stop media capture if it is already stopped.
Examples
stop.onclick = () => {
mediaRecorder.stop();
console.log("recorder stopped, data available");
};
Specifications
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
stop |
49 |
79 |
25 |
No |
36 |
14.1 |
49 |
49 |
25 |
36 |
14 |
5.0 |
See also