MediaRecorder: error Ereignis

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Mehr erfahren
Vollständige Kompatibilität anzeigen

Das error-Ereignis der MediaRecorder-Schnittstelle wird ausgelöst, wenn ein Fehler auftritt, z. B. weil die Aufnahme nicht erlaubt war oder mit einem nicht unterstützten Codec versucht wurde.

Dieses Ereignis ist nicht abbruchfähig und wird nicht weitergereicht.

Syntax

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

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

onerror = (event) => { }

Ereignistyp

Ein MediaRecorderErrorEvent. Erbt von Event.

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

SecurityError: Der MediaStream ist so konfiguriert, dass Aufnahmen nicht erlaubt sind. Dies kann beispielsweise bei Quellen der Fall sein, die mit getUserMedia() bezogen wurden, wenn der Benutzer die Erlaubnis zur Verwendung eines Eingabegeräts verweigert.
InvalidModificationError: Die Anzahl der Tracks im Stream, der aufgezeichnet wird, hat sich geändert. Sie können keine Tracks hinzufügen oder entfernen, während Medien aufgenommen werden.
UnknownError: Es ist ein nicht sicherheitsrelevanter Fehler aufgetreten, der anderweitig nicht kategorisiert werden kann. Die Aufnahme stoppt, der state des MediaRecorders wird inactive, ein letztes dataavailable-Ereignis wird an den MediaRecorder mit den verbleibenden aufgenommenen Daten gesendet, und schließlich wird ein stop-Ereignis gesendet.

Beispiele

Verwendung von addEventListener(), um auf error-Ereignisse zu hören:

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 unter Verwendung der onerror-Ereignishandler-Eigenschaft:

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();