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. Dasmessage
-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 mitgetUserMedia()
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
desMediaRecorder
wirdinactive
, ein letztesdataavailable
-Ereignis wird an denMediaRecorder
mit den verbleibenden empfangenen Daten gesendet und schließlich wird einstop
-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.
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