The MediaRecorder.onerror
event handler (part of the MediaRecorder API) handles the
event, allowing you to run code in response to fatal errors occurring that prevent media capture.DOMError
The errors that can occur when trying to record media are as follows:
Enumeration | Description |
---|---|
InvalidState |
The MediaRecorder is not in a state in which the proposed operation is allowed to be executed. |
OutOfMemory |
The browser has exhausted the available memory. |
IllegalStreamModification |
A modification to the stream has occurred that makes it impossible to continue recording. An example would be the addition of a Track while recording is occurring. |
OtherRecordingError |
Used for a fatal error other than those listed above. |
Syntax
MediaRecorder.onerror = function(event) { ... } MediaRecorder.addEventListener('error', function(event) { ... })
Example
... function(stream) { var mediaRecorder = new MediaRecorder(stream); record.onclick = function() { mediaRecorder.start(); console.log("recorder started"); } mediaRecorder.onerror = function(e) { console.log("An error has occurred: " + e.message); } ...
Properties
- message
- Contains information about the error that occurred.
Specifications
Specification | Status | Comment |
---|---|---|
MediaStream Recording The definition of 'MediaRecorder.onerror' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 47[2] | 25.0 (25.0) | Not supported | Not supported | Not supported |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | Not supported | Not supported | 25.0 (25.0) | 1.3[1] | Not supported | Not supported | Not supported | Not supported |
[1] The intial Firefox OS implementation only supported audio recording.
[2] To try this feature on Chrome, enable Experimental Web Platform features from chrome://flags . Currently only video is supported, not audio.
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