MediaRecorder: stop() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨April 2021⁩.

The stop() method of the MediaRecorder interface 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()

None.

InvalidStateError DOMException: Thrown if the MediaRecorder is currently "inactive"; you cannot stop the recording if the MediaRecorder is not active.

stop.onclick = () => {
  mediaRecorder.stop();
  console.log("recorder stopped, data available");
};

Specification
MediaStream Recording # dom-mediarecorder-stop

This page was last modified on ⁨Feb 8, 2024⁩ by MDN contributors.