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