MediaRecorderErrorEvent: свойство error
Устаревшее: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она может быть удалена из соответствующих веб-стандартов, находится в процессе удаления или поддерживается только для совместимости. Избегайте её использования и обновите существующий код, если это возможно; обратитесь к таблице совместимости в конце этой страницы для принятия решения. Имейте в виду, что эта функция может перестать работать в любое время.
Нестандартная: Эта функция нестандартна и не соответствует стандартам. Не используйте её на производственных сайтах, ориентированных на веб: она не будет работать для всех пользователей. Также могут существовать большие несовместимости между реализациями, и поведение может измениться в будущем.
Свойство error только для чтения интерфейса MediaRecorderErrorEvent — это объект DOMException, предоставляющий подробности об исключении, которое было выброшено экземпляром MediaRecorder.
Когда происходит MediaRecorderErrorEvent, вы можете частично определить причину ошибки, изучив свойство error в объекте MediaRecorderErrorEvent, полученном обработчиком события MediaRecorder error, onerror.
Значение
Объект DOMException, описывающий ошибку, представленную событием. Значение свойства name ошибки может быть любым исключением, которое имеет смысл во время обработки записи медиаданных, включая те, которые специально идентифицированы спецификацией. Описания здесь общие; более конкретные описания для различных сценариев их возникновения вы найдете в соответствующих ссылках на методы.
InvalidStateError-
Операция была выполнена в контексте, в котором это недопустимо, или запрос был выполнен для удаленного или несуществующего объекта.
NotSupportedError-
Невозможно создать
MediaRecorder, потому что указанные параметры недействительны. Свойствоmessageдолжно предоставить дополнительную информацию, если оно существует. SecurityError-
Поток
MediaStreamнастроен таким образом, что запрещает запись. Это может быть, например, в случае с источниками, полученными с помощьюgetUserMedia(), когда пользователь отказывается предоставить разрешение на использование устройства ввода. InvalidModificationError-
Изменилось количество дорожек в записываемом потоке. Нельзя добавлять или удалять дорожки во время записи медиаданных.
UnknownError-
Произошла ошибка, не связанная с безопасностью, которую нельзя отнести к другому типу. Запись прекращается, состояние
MediaRecorderстановитсяinactive, последнее событиеdataavailableотправляется вMediaRecorderс остальными полученными данными, и, наконец, отправляется событиеstop.
Примеры
Пример обработки ошибок
Эта функция создаёт и возвращает MediaRecorder для заданного MediaStream, настроенного для буферизации данных в массив и отслеживания ошибок.
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;
}
Спецификации
Эта функция больше не является частью какой-либо спецификации и не планируется стать стандартной.
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
error |
Нет | Нет | 57 | Нет | 14 | Нет | 57 | Нет | 14 | Нет | Нет |
См. также
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorderErrorEvent/error