MediaRecorder: state property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
The state read-only property of the MediaRecorder interface returns the current state of the current MediaRecorder object.
Value
A string containing one of the following values:
inactive-
Recording is not occurring — it has either not been started yet, or it has been started and then stopped.
recording-
Recording has been started and the user agent is capturing data.
paused-
Recording has been started, then paused, but not yet stopped or resumed.
Examples
js
record.onclick = () => {
mediaRecorder.start();
console.log(mediaRecorder.state);
// Will return "recording"
console.log("recorder started");
};
Specifications
| Specification |
|---|
| MediaStream Recording # dom-mediarecorder-state |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
state
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- Has more compatibility info.
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()