The MediaRecorder.onerror event handler (part of the MediaRecorder API) handles the DOMError event, allowing you to run code in response to fatal errors occurring that prevent media capture.

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.


MediaRecorder.onerror = function(event) { ... }
MediaRecorder.addEventListener('error', function(event) { ... })



  function(stream) {
    var mediaRecorder = new MediaRecorder(stream);

    record.onclick = function() {
      console.log("recorder started");

    mediaRecorder.onerror = function(e) {
      console.log("An error has occurred: " + e.message);



Contains information about the error that occurred.


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


© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

API Audio Media Capture Media Recorder API MediaRecorder onerror Property Reference Video