MediaRecorder: resume() method
The MediaRecorder.resume()
method (part of the MediaStream Recording 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
js
resume()
Parameters
None.
Return value
None (undefined).
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.
Examples
js
pause.onclick = () => {
if (MediaRecorder.state === "recording") {
mediaRecorder.pause();
// recording paused
} else if (MediaRecorder.state === "paused") {
mediaRecorder.resume();
// resume recording
}
};
Specifications
| Specification |
|---|
| MediaStream Recording # dom-mediarecorder-resume |
Browser compatibility
BCD tables only load in the browser
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