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: zum Beispiel, weil die Aufnahme nicht erlaubt ist oder ein nicht unterstützter Codec verwendet wurde.
Dieses Ereignis ist nicht abbruchfähig und wird nicht weitergeleitet.
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.
Ereigniseigenschaften
Erbt Eigenschaften von seiner Elternschnittstelle, Event.
errorSchreibgeschützt-
Ein
DOMException, das Informationen über den aufgetretenen Fehler enthält.
Beschreibung
Auslöser
Eine Funktion, die aufgerufen wird, wenn während der Lebensdauer des Recorders ein Fehler auftritt. Neben anderen allgemeinen Fehlern, die auftreten können, sind folgende Fehler beim Verwenden der MediaStream Recording API speziell möglich; um festzustellen, welcher aufgetreten ist, prüfen Sie den Wert von MediaRecorderErrorEvent.error.name.
SecurityError-
Der
MediaStreamist so konfiguriert, dass Aufnahmen nicht erlaubt sind. Dies kann zum Beispiel der Fall sein, wenn Quellen mitgetUserMedia()abgerufen wurden und der Benutzer die Erlaubnis zur Verwendung 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 sicherheitsrelevanter Fehler ist aufgetreten, der nicht anders kategorisiert werden kann. Die Aufnahme stoppt, der
statedesMediaRecorderwirdinactive, ein letztesdataavailable-Ereignis wird an denMediaRecordermit den verbleibenden empfangenen Daten gesendet, und schließlich wird einstop-Ereignis gesendet.
Beispiele
Verwendung von addEventListener(), um error-Ereignisse zu überwachen:
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-Ereignis-Handler-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 |
Browser-Kompatibilität
Loading…