MediaRecorderErrorEvent: error-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch 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