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.state
is "inactive", raise a DOMInvalidState
error and terminate these steps. IfMediaRecorder.state
is not "inactive", continue to the next step. - Set
MediaRecorder.state
to "recording". - Continue gathering data into the current
Blob
. - Raise a
resume
event.
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