MediaRecorder: pause() method
The MediaRecorder.pause() method (part
of the MediaStream Recording 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:
-
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
BCD tables only load in the browser
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