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 is "inactive", raise a DOM InvalidState error and terminate these steps. If not, continue to the next step.
  2. Set MediaRecorder.state 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 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
The definition of 'MediaRecorder.pause()' in that specification.
Working Draft Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome ? Edge ? Firefox Full support 25IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android Full support 25Opera Android ? Safari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

See also

Document Tags and Contributors

Contributors to this page: lucian95, Sheppy, jpmedley, Sebastianz, chrisdavidmills, teoli, kscarfone
Last updated by: lucian95,