Spec-Zone.ru › Web APIs

XMLHttpRequestUpload: событие error

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

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

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Потоках Web Workers, за исключением Рабочих потоков Service Workers.

Событие error срабатывает, когда запрос столкнулся с ошибкой.

Синтаксис

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

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

onerror = (event) => {};

Тип события

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

Событие ProgressEvent

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

В дополнение к свойствам, перечисленным ниже, доступны свойства из родительского интерфейса Event.

lengthComputable Только для чтения

Логический флаг, указывающий, вычисляется ли общий объем работы, выполняемой базовым процессом, и количество уже выполненной работы. Другими словами, он показывает, измеряется ли прогресс или нет.

loaded Только для чтения

Целое беззнаковое 64-битное значение, указывающее количество работы, уже выполненной базовым процессом. Соотношение выполненной работы можно рассчитать, разделив total на значение этого свойства. При загрузке ресурса с помощью HTTP, это значение учитывает только тело сообщения HTTP и не включает заголовки и другие накладные расходы.

total Только для чтения

Целое беззнаковое 64-битное значение, представляющее общий объем работы, которую базовый процесс выполняет в процессе. При загрузке ресурса с помощью HTTP, это значение равно Content-Length (размер тела сообщения) и не включает заголовки и другие накладные расходы.

Примеры

Использование события error

Вы можете использовать событие error для обнаружения проблем с загрузкой. Для полного примера кода, который загружает файл и отображает полосу прогресса, см. основную страницу XMLHttpRequestUpload.

// In case of an error we hide the progress bar
// Note that this event can be listened to on the xhr object too
function errorAction(event) {
  progressBar.classList.remove("visible");
  log.textContent = `Upload failed: ${event.type}`;
}
xhr.upload.addEventListener("error", errorAction);

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

Спецификация
XMLHttpRequest
# event-xhr-error
XMLHttpRequest
# handler-xhr-onerror

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
error_event 2 12 3.5 ≤12.1 4 18 4 ≤12.1 3 1.0 ≤37

См. также

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

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

Spec-Zone.ru

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