MediaRecorder: pause() 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 pause() method of the MediaRecorder interface 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:
- If
MediaRecorder.stateis "inactive", raise a DOMInvalidStateerror and terminate these steps. If not, continue to the next step. - Set
MediaRecorder.stateto "paused". - Stop gathering data into the current
Blob, but keep it available so that recording can be resumed later on. - Raise a
pauseevent.
Syntax
js
pause()
Parameters
None.
Return value
None (undefined).
Exceptions
InvalidStateErrorDOMException-
Thrown if the
MediaRecorderis currently"inactive"; you cannot pause the recording if theMediaRecorderis not active. If you callpause()while already paused, the method silently does nothing.
Examples
js
pause.onclick = () => {
mediaRecorder.pause();
console.log("recording paused");
};
Specifications
| Specification |
|---|
| MediaStream Recording> # dom-mediarecorder-pause> |
Browser compatibility
Loading…
See also
- Using the MediaStream Recording API
- Web Dictaphone: MediaRecorder + getUserMedia + Web Audio API visualization demo, by Chris Mills (source on GitHub.)
- simpl.info MediaStream Recording demo, by Sam Dutton.
Navigator.getUserMedia