MediaRecorder.pause()
The Media.pause() method (part of the MediaRecorder API (en-US)) 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.state(en-US) is "inactive", raise a DOMInvalidStateerror and terminate these steps. If not, continue to the next step. - Set
MediaRecorder.state(en-US) to "paused". - Stop gathering data into the current
Blob, but keep it available so that recording can be resumed later on. - Raise a
pauseevent.
Syntax
MediaRecorder.pause()
Return value
undefined.
Exceptions
InvalidStateError-
The
MediaRecorderis currently"inactive"; you can't pause recording if it's not active. If you callpause()while already paused, it silently does nothing.
Example
js
...
pause.onclick = function() {
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 MediaRecorder API (en-US)
- 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