XMLHttpRequestUpload: событие abort
Базовая поддержка Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Примечание: Эта функция доступна в Потоках веб-работников, за исключением Сервисных работников.
Событие abort срабатывает в XMLHttpRequestUpload, когда запрос прерван, например, потому что программа вызвала XMLHttpRequest.abort().
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика события.
addEventListener("abort", (event) => {});
onabort = (event) => {};
Тип события
Объект ProgressEvent. Наследуется от Event.
Свойства события
Помимо перечисленных ниже свойств, доступны свойства родительского интерфейса Event.
-
lengthComputableТолько чтение -
Флаг boolean, указывающий, можно ли вычислить общее количество работ, выполняемых подлежащим процессом, и количество уже выполненных работ. Другими словами, он показывает, можно ли измерить прогресс или нет.
-
loadedТолько чтение -
Целочисленное значение с плавающей запятой, указывающее количество работ, уже выполненных подлежащим процессом. Соотношение проделанной работы можно рассчитать, разделив
totalна значение этого свойства. При загрузке ресурса с помощью HTTP это учитывает только тело HTTP сообщения и не включает заголовки и другие накладные расходы. -
totalТолько чтение -
Целочисленное значение с плавающей запятой, представляющее общее количество работ, которые подлежащий процесс выполняет. При загрузке ресурса с помощью HTTP это
Content-Length(размер тела сообщения) и не включает заголовки и другие накладные расходы.
Примеры
Использование события abort
Вы можете использовать событие abort для остановки загрузки перед ее завершением. Полный пример кода, который загружает файл и отображает полосу прогресса, см. на главной странице XMLHttpRequestUpload.
// In case of an abort 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("abort", errorAction);
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
abort_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/abort_event