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:
- 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
MediaRecorder.pause()
Return value
undefined
.
Exceptions
InvalidStateError
-
The
MediaRecorder
is currently"inactive"
; you can't pause recording if it's not active. If you callpause()
while already paused, it silently does nothing.
Example
... pause.onclick = function() { mediaRecorder.pause(); console.log("recording paused"); } ...
Specifications
Specification |
---|
MediaStream Recording # dom-mediarecorder-pause |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
pause |
49 |
79 |
25 |
No |
36 |
14.1 |
49 |
49 |
25 |
36 |
14.5 |
5.0 |
See also
- Using the MediaRecorder 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
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorder/pause