MediaRecorder: error-Event

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Das error-Ereignis der MediaRecorder-Schnittstelle wird ausgelöst, wenn ein Fehler auftritt: beispielsweise weil die Aufnahme nicht erlaubt war oder ein nicht unterstützter Codec verwendet wurde.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergereicht.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("error", (event) => { })

onerror = (event) => { }

Ereignistyp

Ereigniseigenschaften

Erbt Eigenschaften von seiner Elternschnittstelle, Event.

error Schreibgeschützt

Ein DOMException, das Informationen über den aufgetretenen Fehler enthält.

Beschreibung

Auslöser

Eine Funktion, die immer dann aufgerufen wird, wenn während der Lebensdauer des Aufnahmegeräts ein Fehler auftritt. Zusätzlich zu anderen allgemeinen Fehlern, die auftreten können, sind die folgenden Fehler speziell möglich, wenn die MediaStream Recording API verwendet wird; um festzustellen, welcher aufgetreten ist, überprüfen Sie den Wert von MediaRecorderErrorEvent.error.name.

SecurityError

Der MediaStream ist so konfiguriert, dass Aufnahmen nicht erlaubt sind. Dies kann zum Beispiel der Fall sein, wenn Quellen, die mithilfe von getUserMedia() erhalten wurden, verwendet werden, wenn der Benutzer die Berechtigung zur Nutzung eines Eingabegeräts verweigert.

InvalidModificationError

Die Anzahl der Tracks im Stream, der aufgenommen wird, hat sich geändert. Sie können während der Medienaufnahme keine Tracks hinzufügen oder entfernen.

UnknownError

Ein nicht sicherheitsbezogener Fehler ist aufgetreten, der sonst nicht kategorisiert werden kann. Die Aufnahme stoppt, der state des MediaRecorder wird inactive, ein letztes dataavailable-Ereignis wird mit den verbleibenden empfangenen Daten an den MediaRecorder gesendet, und schließlich wird ein stop-Ereignis gesendet.

Beispiele

Verwendung von addEventListener() zum Abhören von error-Ereignissen:

js
async function record() {
  const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
  const recorder = new MediaRecorder(stream);
  recorder.addEventListener("error", (event) => {
    console.error(`error recording stream: ${event.error.name}`);
  });
  recorder.start();
}

record();

Das Gleiche, aber mit der onerror-Ereignishandler-Eigenschaft:

js
async function record() {
  const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
  const recorder = new MediaRecorder(stream);
  recorder.onerror = (event) => {
    console.error(`error recording stream: ${event.error.name}`);
  };
  recorder.start();
}

record();

Spezifikationen

Specification
MediaStream Recording
# dom-mediarecorder-onerror

Browser-Kompatibilität

Siehe auch