MediaRecorder: requestData() method
The MediaRecorder.requestData()
method (part of the MediaStream Recording API) is used to raise a dataavailable event containing a
Blob object of the captured media as it was when the method was
called. This can then be grabbed and manipulated as you wish.
When the requestData() 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. -
Raise a
dataavailableevent containing aBlobof the currently captured data (the Blob is available under the event'sdataattribute.) - Create a new Blob and place subsequently captured data into it.
Syntax
js
requestData()
Parameters
None.
Return value
None (undefined).
Errors
An InvalidState error is raised if the requestData() method
is called while the MediaRecorder object's
MediaRecorder.state is not "recording" — the media cannot be captured if
recording is not occurring.
Examples
js
captureMedia.onclick = () => {
mediaRecorder.requestData();
// makes snapshot available of data so far
// ondataavailable fires, then capturing continues
// in new Blob
};
Specifications
| Specification |
|---|
| MediaStream Recording # dom-mediarecorder-requestdata |
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