XMLHttpRequestUpload: событие loadstart
Базовая поддержка Широко распространена
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Примечание: Эта функция доступна в рабочих потоках, за исключением сервисных рабочих потоков.
Событие loadstart срабатывает, когда запрос начинает загружать данные.
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика события.
addEventListener("loadstart", (event) => {});
onloadstart = (event) => {};
Тип события
Объект типа ProgressEvent. Наследуется от Event.
Свойства события
Помимо перечисленных ниже свойств, доступны свойства из родительского интерфейса, Event.
-
lengthComputableТолько для чтения -
Логическое значение, указывающее, можно ли вычислить объём работы, который должен быть выполнен, и объём работы, уже выполненный, подлежащей обработкой. Другими словами, оно показывает, можно ли измерить прогресс или нет.
-
loadedТолько для чтения -
Целое беззнаковое 64-битное значение, указывающее объём работы, уже выполненной подлежащей обработкой. Соотношение проделанной работы можно вычислить, разделив
totalна значение этого свойства. При загрузке ресурса с помощью HTTP, это значение учитывает только тело HTTP-сообщения, и не включает заголовки и другие накладные расходы. -
totalТолько для чтения -
Целое беззнаковое 64-битное значение, представляющее общий объём работы, выполняемой подлежащей обработкой. При загрузке ресурса с помощью HTTP, это значение равно
Content-Length(размер тела сообщения), и не включает заголовки и другие накладные расходы.
Примеры
Использование события loadstart
Вы можете использовать событие loadstart для обнаружения начала загрузки. Полный пример кода, загружающий файл и отображающий полосу прогресса, см. на главной странице XMLHttpRequestUpload.
// When the upload starts, we display the progress bar
xhr.upload.addEventListener("loadstart", (event) => {
progressBar.classList.add("visible");
progressBar.value = 0;
progressBar.max = event.total;
log.textContent = "Uploading (0%)…";
abortButton.disabled = false;
});
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
loadstart_event |
2 | 12 | 3.5 | ≤12.1 | 4 | 18 | 4 | ≤12.1 | 3 | 1.0 | 4.4 |
См. также
© 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/loadstart_event