MediaRecorder: resume() method
The resume()
method of the MediaRecorder
interface is used to resume media recording when it has been previously paused.
If MediaRecorder.state
is already "recording", calling resume()
has no effect.
When the resume()
method is invoked, the browser queues a task that runs
the following steps:
- If
MediaRecorder.state
is "inactive", raise a DOMInvalidStateError
exception 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
).
Exceptions
InvalidStateError
DOMException
-
Thrown if the
MediaRecorder
is currently"inactive"
.
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