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.
addEventListener("error", (event) => { })
onerror = (event) => { }
Ereignistyp
Ein MediaRecorderErrorEvent
. Erbt von Event
.
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 vongetUserMedia()
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
desMediaRecorder
wirdinactive
, ein letztesdataavailable
-Ereignis wird mit den verbleibenden empfangenen Daten an denMediaRecorder
gesendet, und schließlich wird einstop
-Ereignis gesendet.
Beispiele
Verwendung von addEventListener()
zum Abhören von error
-Ereignissen:
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:
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 |