Книга: JavaScript. Подробное руководство, 6-е издание

XMLHttpRequestUpload

XMLHttpRequestUpload

(EventTarget)

Объект XMLHttpRequestUpload определяет множество свойств регистрации обработчиков событий для слежения за ходом выгрузки тела HTTP-запроса. В броузерах, реализующих положения спецификации «XMLHttpRequest Level 2», каждый объект XMLHttpRequest имеет свойство upload, ссылающееся на объект этого типа. Чтобы реализовать слежение за ходом выполнения операции выгрузки, достаточно просто установить соответствующие обработчики событий с помощью следующих свойств или методов интерфейса EventTarget. Обратите внимание, что перечисленные ниже свойства регистрации обработчиков событий для слежения за процессом выгрузки в точности соответствуют свойствам регистрации обработчиков событий для слежения за процессом загрузки, которые определяются самим объектом XMLHttpRequest, за исключением свойства onreadystatechange.

Обработчики событий

onabort

Вызывается при прерывании выгрузки.

onerror

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

onload

Вызывается в случае успешного завершения выгрузки

onloadend

Вызывается в случае успешного или неудачного завершения выгрузки. Событие «loadend» всегда следует за событиями «load», «abort», «error» и «timeout».

onloadstart

Вызывается с началом выгрузки.

onprogress

Вызывается периодически (примерно раз в 50 миллисекунд) в ходе выгрузки.

ontimeout

Вызывается, если истекло время ожидания, определяемое свойством timeout объекта XMLHttpRequest.

Оглавление книги