Spec-Zone.ru › Web APIs

XMLHttpRequestUpload: событие loadstart

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

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

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

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

Событие loadstart срабатывает, когда запрос начинает загружать данные.

Синтаксис

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

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

onloadstart = (event) => {};

Тип события

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

Событие ProgressEvent

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

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

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

Спецификация
XMLHttpRequest
# event-xhr-loadstart
XMLHttpRequest
# handler-xhr-onloadstart

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

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

См. также

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

Spec-Zone.ru

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