The MediaRecorder.pause()
method (part of the MediaStream Recording 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 DOM InvalidState
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
Parameters
Return value
Exceptions
InvalidStateError
DOMException
-
Thrown if the MediaRecorder
is currently "inactive"
; you cannot pause the recording if the MediaRecorder
is not active. If you call pause()
while already paused, the method silently does nothing.
Examples
pause.onclick = () => {
mediaRecorder.pause();
console.log("recording paused");
};
Specifications
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
pause |
49 |
79 |
25 |
No |
36 |
14.1 |
49 |
49 |
25 |
36 |
14.5 |
5.0 |
See also