MediaRecorder: pause() method
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.state
is "inactive", raise a DOMInvalidState
error and terminate these steps. If not, continue to the next step. - Set
MediaRecorder.state
to "paused". - Stop gathering data into the current
Blob
, but keep it available so that recording can be resumed later on. - Raise a
pause
event.
Syntax
js
pause()
Parameters
None.
Return value
None (undefined
).
Exceptions
InvalidStateError
DOMException
-
Thrown if the
MediaRecorder
is currently"inactive"
; you cannot pause the recording if theMediaRecorder
is 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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
pause |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
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