XMLHttpRequestUpload: событие loadend

Событие loadend срабатывает при завершении запроса, успешно (после load) или безуспешно (после abort или error).

Событие loadend также отправляется, когда запрос был прерван (из-за timeout, abort или error). В таких случаях значения loaded и total события будут равны 0.

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

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

onloadend = (event) => {};

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

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

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

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

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

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

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

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

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

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

• Связанные события: loadstart, progress, error, load, abort, timeout
• XMLHttpRequestUpload