FileReader: событие error

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

Примечание: Эта функция доступна в Потоках Web Workers.

Событие error интерфейса FileReader срабатывает, когда чтение завершилось с ошибкой (например, потому что файл не найден или недоступен для чтения).

Это событие не отменяется и не распространяется.

Синтаксис

Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика события.

addEventListener("error", (event) => {});

onerror = (event) => {};

Тип события

Объект ProgressEvent. Наследуется от Event.

Свойства события

Также наследует свойства от родительского объекта Event.

ProgressEvent.lengthComputable Только для чтения: Флаг булевого типа, указывающий, может ли быть вычислена общая работа, выполняемая базовым процессом, и объем уже выполненной работы. Другими словами, он показывает, можно ли измерить прогресс.
ProgressEvent.loaded Только для чтения: Значение беззнакового целого 64-битного числа, указывающее объем работы, уже выполненной базовым процессом. Соотношение выполненной работы можно рассчитать, разделив total на значение этого свойства. При загрузке ресурса с использованием HTTP, это значение учитывает только тело HTTP-сообщения и не включает заголовки и другую служебную информацию.
ProgressEvent.total Только для чтения: Беззнаковое целое 64-битное число, представляющее общий объем работы, которую базовый процесс выполняет. При загрузке ресурса с использованием HTTP, это значение равно Content-Length (размер тела сообщения) и не включает заголовки и другую служебную информацию.

Примеры

const fileInput = document.querySelector('input[type="file"]');
const reader = new FileReader();

function handleSelected(e) {
  const selectedFile = fileInput.files[0];
  if (selectedFile) {
    reader.addEventListener("error", () => {
      console.error(`Error occurred reading file: ${selectedFile.name}`);
    });

    reader.addEventListener("load", () => {
      console.log(`File: ${selectedFile.name} read successfully`);
    });

    reader.readAsDataURL(selectedFile);
  }
}

fileInput.addEventListener("change", handleSelected);

Спецификации

Спецификация
File API # dfn-error-event
File API # dfn-onerror

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`error_event`	6	12	3.6	11	6	18	32	11	6	1.0	3

См. также

Связанные события: loadstart, loadend, progress, load, abort

© 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/FileReader/error_event