W3cubDocs

/Web APIs

MediaRecorder: stop() method

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

stop()

Parameters

None.

Return value

None (undefined).

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

Specification
MediaStream Recording # dom-mediarecorder-stop

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