Spec-Zone.ru › Web APIs

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 Нет Нет

См. также

  • API записи MediaStream
  • Использование API записи MediaStream

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API