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

[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