MediaRecorder.stop()
The MediaRecorder.stop()
method
(part of the MediaRecorder API) is
used to stop media capture.
When the stop()
method is invoked, the UA queues a task that runs the
following steps:
-
If
MediaRecorder.state
is "inactive", raise a DOMInvalidState
error and terminate these steps. If theMediaRecorder.state
is not "inactive", continue on to the next step. - Set the
MediaRecorder.state
to "inactive" and stop capturing media. -
Raise a
dataavailable
event containing the Blob of data that has been gathered. - Raise a
stop
event.
Syntax
MediaRecorder.stop()
Errors
An InvalidState
error is raised if the stop()
method is
called while the MediaRecorder
object's MediaRecorder.state
is "inactive" — it makes no sense to stop media capture if it is already stopped.
Example
...
stop.onclick = function() {
mediaRecorder.stop();
console.log("recorder stopped, data available");
}
...
Specifications
Specification |
---|
MediaStream Recording # dom-mediarecorder-stop |
Browser compatibility
BCD tables only load in the browser
See also
- Using the MediaRecorder 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