The MediaRecorder.resume() method (part of the MediaRecorder API) is used to resume media recording when it has been previously paused.
When the resume() method is invoked, the browser queues a task that runs the following steps:
- If
MediaRecorder.stateis "inactive", raise a DOMInvalidStateerror and terminate these steps. IfMediaRecorder.stateis not "inactive", continue to the next step. - Set
MediaRecorder.stateto "recording". - Continue gathering data into the current
Blob. - Raise a
resumeevent.
Syntax
MediaRecorder.resume()
Errors
An InvalidState error is raised if the resume() method is called while the MediaRecorder object’s MediaRecorder.state is "inactive" — the recording cannot be resumed if it is not already paused; if MediaRecorder.state is already "recording", resume() has no effect.
Example
...
pause.onclick = function() {
if(MediaRecorder.state === "recording") {
mediaRecorder.pause();
// recording paused
} else if(MediaRecorder.state === "paused") {
mediaRecorder.resume();
// resume recording
}
}
...
Specifications
| Specification | Status | Comment |
| MediaStream RecordingThe definition of 'MediaRecorder.resume()' in that specification. | Working Draft | Initial definition |
Browser compatibility
The compatibility table in 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.
Update compatibility data on GitHub
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
resume
|
Chrome
Full support 49 |
Edge
Full support 79 |
Firefox
Full support 25 |
IE
No support No |
Opera
Full support 36 |
Safari
No support No |
WebView Android
Full support 49 |
Chrome Android
Full support 49 |
Firefox Android
Full support 25 |
Opera Android
Full support 36 |
Safari iOS
No support No |
Samsung Internet Android
Full support 5.0 |
Legend
- Full support
- Full support
- No support
- No support
See also
- Using the MediaRecorder API
- [[../../../../../../../mdn.github.io/web-dictaphone/index|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
MediaRecorder.resume() by Mozilla Contributors is licensed under CC-BY-SA 2.5.