MediaRecorderErrorEvent: error-Eigenschaft
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die error-Eigenschaft, die nur lesbar ist, des MediaRecorderErrorEvent-Interfaces ist ein DOMException-Objekt, das Details über die Ausnahme bereitstellt, die von einer MediaRecorder-Instanz ausgelöst wurde.
Wenn ein MediaRecorderErrorEvent auftritt, können Sie durch Ãberprüfung der error-Eigenschaft innerhalb des MediaRecorderErrorEvent, das vom MediaRecorder's error-Ereignishandler, onerror, empfangen wird, in gewissem MaÃe bestimmen, was schiefgelaufen ist.
Wert
Ein DOMException, der den vom Ereignis dargestellten Fehler beschreibt. Der Wert der name-Eigenschaft des Fehlers kann jede Ausnahme sein, die während der Handhabung der Medienaufnahme sinnvoll ist, einschlieÃlich der im Standard speziell identifizierten. Die hier dargestellten Beschreibungen sind generisch; spezifischere Beschreibungen für verschiedene Szenarien, in denen sie auftreten können, finden Sie in den entsprechenden Methodenreferenzen.
InvalidStateError-
Eine Operation wurde in einem Kontext versucht, in dem sie nicht zulässig ist, oder eine Anfrage wurde an ein Objekt gestellt, das gelöscht oder entfernt wurde.
NotSupportedError-
Ein
MediaRecorderkonnte nicht erstellt werden, weil die angegebenen Optionen nicht gültig waren. Dasmessage-Attribut sollte zusätzliche Informationen liefern, falls vorhanden. SecurityError-
Der
MediaStreamist so konfiguriert, dass die Aufnahme nicht erlaubt ist. Dies kann beispielsweise der Fall sein, wenn Quellen übergetUserMedia()erhalten wurden und der Benutzer die Erlaubnis zur Nutzung eines Eingabegeräts verweigert hat. InvalidModificationError-
Die Anzahl der Tracks im Stream, der aufgenommen wird, hat sich geändert. Sie können keine Tracks hinzufügen oder entfernen, während Medien aufgenommen werden.
UnknownError-
Es ist ein nicht sicherheitsbezogener Fehler aufgetreten, der nicht anderweitig kategorisiert werden kann. Die Aufnahme stoppt, der
statedesMediaRecorderwechselt zuinactive, ein letztesdataavailable-Ereignis wird an denMediaRecordermit den verbleibenden empfangenen Daten gesendet, und schlieÃlich wird einstop-Ereignis gesendet.
Beispiele
Grundlegendes Beispiel zur Fehlerbehandlung
Diese Funktion erstellt und gibt einen MediaRecorder für einen gegebenen MediaStream zurück, der so konfiguriert ist, dass Daten in einen 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
Diese Funktion ist nicht mehr Teil einer Spezifikation und wird nicht mehr als Standard verfolgt.