MediaRecorder.pause()

The Media.pause() method (part of the MediaRecorder API) is used to pause recording of media streams.

When a MediaRecorder object’s pause()method is called, the browser queues a task that runs the below steps:

  1. If MediaRecorder.state (en-US) is "inactive", raise a DOM InvalidState error and terminate these steps. If not, continue to the next step.
  2. Set MediaRecorder.state (en-US) to "paused".
  3. Stop gathering data into the current Blob, but keep it available so that recording can be resumed later on.
  4. Raise a pause (en-US) event.

Syntax

MediaRecorder.pause()

Return value

undefined.

Exceptions

InvalidStateError
The MediaRecorder is currently "inactive"; you can't pause recording if it's not active. If you call pause() while already paused, it silently does nothing.

Example

...

 pause.onclick = function() {
     mediaRecorder.pause();
     console.log("recording paused");
 }

...

Specifications

Specification Status Comment
MediaStream Recording
MediaRecorder.pause()
Working Draft Initial definition

Browser compatibility

BCD tables only load in the browser

See also