XMLHttpRequestUpload: событие error
Базовая поддержка Широко доступно
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Примечание: Эта функция доступна в Потоках Web Workers, за исключением Рабочих потоков Service Workers.
Событие error срабатывает, когда запрос столкнулся с ошибкой.
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика события.
addEventListener("error", (event) => {});
onerror = (event) => {};
Тип события
Объект ProgressEvent. Наследуется от Event.
Свойства события
В дополнение к свойствам, перечисленным ниже, доступны свойства из родительского интерфейса 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);
Спецификации
Совместимость браузеров
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
См. также
© 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