Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

MediaRecorder.onerror

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.

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

Document Tags and Contributors

 Contributors to this page: jpmedley, Sebastianz, chrisdavidmills, teoli, kscarfone
 Last updated by: jpmedley,