Spec-Zone.ru › Web APIs

XMLHttpRequestUpload: событие abort

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

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

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

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

Событие abort срабатывает в XMLHttpRequestUpload, когда запрос прерван, например, потому что программа вызвала XMLHttpRequest.abort().

Синтаксис

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

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

onabort = (event) => {};

Тип события

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

Событие ProgressEvent

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

Помимо перечисленных ниже свойств, доступны свойства родительского интерфейса 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);

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

Спецификация
XMLHttpRequest
# event-xhr-abort
XMLHttpRequest
# handler-xhr-onabort

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

Рабочие столы Мобильные устройства
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

См. также

  • Связанные события: loadstart, load, progress, error, 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/abort_event

Spec-Zone.ru

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