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 | Status | Comment |
---|---|---|
MediaStream Recording The definition of 'MediaRecorder.pause()' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | No support[1] | 25.0 (25.0) | No support | No support | No support |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | No support | No support | 25.0 (25.0) | 1.3[1] | No support | No support | No support | No support |
[1] The intial Firefox OS implementation only supported audio recording.
[2] To try this feature on Chrome, enable Experimental Web Platform features from chrome://flags . Currently only video is supported, not audio.
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