Spec-Zone.ru › Web APIs

XMLHttpRequestUpload: событие load

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

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

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

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

Событие load срабатывает, когда транзакция XMLHttpRequestUpload успешно завершается.

Синтаксис

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

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

onload = (event) => {};

Тип события

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

Событие ProgressEvent

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

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

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

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

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

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

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

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

Примеры

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

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

// When the upload is finished, we hide the progress bar.
xhr.upload.addEventListener("load", (event) => {
  progressBar.classList.remove("visible");
  log.textContent = "Upload finished.";
  abortButton.disabled = true;
});

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

Спецификация
XMLHttpRequest
# event-xhr-load
XMLHttpRequest
# handler-xhr-onload

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

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

См. также

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

Spec-Zone.ru

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