MediaRecorderErrorEvent: error-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

Die error-Eigenschaft (nur lesbar) des MediaRecorderErrorEvent-Interfaces ist ein DOMException-Objekt, das Details über die vom MediaRecorder-Instanz ausgelöste Ausnahme bereitstellt.

Wenn ein MediaRecorderErrorEvent auftritt, können Sie bis zu einem gewissen Grad feststellen, was schiefgelaufen ist, indem Sie die error-Eigenschaft im MediaRecorderErrorEvent untersuchen, das vom error-Ereignishandler des MediaRecorder, onerror, empfangen wird.

Wert

Eine DOMException, die den durch das Ereignis dargestellten Fehler beschreibt. Der Wert der name-Eigenschaft des Fehlers kann jede Ausnahme sein, die im Zusammenhang mit der Medienaufnahme sinnvoll ist, einschließlich derer, die in der Spezifikation ausdrücklich identifiziert sind. Die hier beschriebenen sind allgemein gehalten; spezifischere für verschiedene Szenarien, in denen sie auftreten können, finden Sie in den entsprechenden Methodenreferenzen.

InvalidStateError

Es wurde versucht, eine Operation in einem Kontext auszuführen, in dem sie nicht erlaubt ist, oder es wurde eine Anfrage an ein Objekt gestellt, das gelöscht oder entfernt wurde.

NotSupportedError

Ein MediaRecorder konnte nicht erstellt werden, da die angegebenen Optionen ungültig waren. Das message-Attribut sollte zusätzliche Informationen liefern, falls vorhanden.

SecurityError

Der MediaStream ist so konfiguriert, dass die Aufnahme nicht erlaubt ist. Dies kann beispielsweise der Fall sein bei Quellen, die mit getUserMedia() bezogen wurden, wenn der Benutzer die Berechtigung zur Nutzung eines Eingabegeräts verweigert.

InvalidModificationError

Die Anzahl der Spuren im Stream, der aufgenommen wird, hat sich geändert. Es ist nicht möglich, Spuren hinzuzufügen oder zu entfernen, während Medien aufgenommen werden.

UnknownError

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

Beispiele

Einfaches Fehlerbehandlungsbeispiel

Diese Funktion erstellt und gibt einen MediaRecorder für einen bestimmten MediaStream zurück, der so konfiguriert ist, dass Daten in einem Array gepuffert und auf Fehler überwacht werden.

js
function recordStream(stream) {
  let recorder = null;
  let bufferList = [];

  try {
    recorder = new MediaRecorder(stream);
  } catch (err) {
    /* exception while trying to create the recorder; handle that */
  }

  recorder.ondataavailable = (event) => {
    bufferList.push(event.data);
  };

  recorder.onerror = (event) => {
    console.error(`Error: ${event.error}`);
  };

  recorder.start(100); /* 100ms time slices per buffer */
  return recorder;
}

Spezifikationen

Dieses Feature ist nicht mehr Teil einer Spezifikation und nicht mehr auf dem Weg, ein Standard zu werden.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch