См. также описание свойства upload и
<b>XMLHttpRequestUpload</b>
, где приводится список событий, которые можно использовать для слежения за ходом выгрузки тела НТТР-запроса.
<b>onabort</b>
Вызывается при прерывании запроса.
<b>onerror</b>
Вызывается в случае завершения запроса по ошибке. Обратите внимание, что HTTP-коды состояния, такие как 404, не считаются ошибкой, поскольку сам ответ получен успешно. Однако это событие может породить отрицательный ответ сервера DNS или бесконечный цикл переадресаций.
<b>onload</b>
Вызывается при успешном выполнении запроса.
<b>onloadend</b>
Вызывается в случае успешного или неудачного завершения запроса, после событий «load», «abort», «error» и «timeout».
<b>onloadstart</b>
Вызывается с началом выполнения запроса.
<b>onprogress</b>
Вызывается периодически (примерно раз в 50 миллисекунд) в ходе загрузки тела ответа.
<b>onreadystatechange</b>
Вызывается при изменении значения свойства
<b>readyState</b>
. Наиболее важен для обработки ситуации завершения запроса.
<b>ontimeout</b>
Вызывается, если истекло время ожидания, определяемое свойством timeout, а ответ так и не был принят.
XMLHttpRequestUpload
(EventTarget)
Объект
<b>XMLHttpRequestUpload</b>
определяет множество свойств регистрации обработчиков событий для слежения за ходом выгрузки тела HTTP-запроса. В броузерах, реализующих положения спецификации «XMLHttpRequest Level 2», каждый объект
<b>XMLHttpRequest</b>
имеет свойство
<b>upload</b>
, ссылающееся на объект этого типа. Чтобы реализовать слежение за ходом выполнения операции выгрузки, достаточно просто установить соответствующие обработчики событий с помощью следующих свойств или методов интерфейса
<b>EventTarget</b>
. Обратите внимание, что перечисленные ниже свойства регистрации обработчиков событий для слежения за процессом выгрузки в точности соответствуют свойствам регистрации обработчиков событий для слежения за процессом загрузки, которые определяются самим объектом
<b>XMLHttpRequest</b>
, за исключением свойства
<b>onreadystatechange</b>
.
Обработчики событий
<b>onabort</b>
Вызывается при прерывании выгрузки.
<b>onerror</b>
Вызывается, когда в процессе выгрузки возникает сетевая ошибка.
onload
Вызывается в случае успешного завершения выгрузки
<b>onloadend</b>
Вызывается в случае успешного или неудачного завершения выгрузки. Событие «loadend» всегда следует за событиями «load», «abort», «error» и «timeout».
<b>onloadstart</b>
Вызывается с началом выгрузки.
<b>onprogress</b>
Вызывается периодически (примерно раз в 50 миллисекунд) в ходе выгрузки.
<b>ontimeout</b>
Вызывается, если истекло время ожидания, определяемое свойством
<b>timeout</b>
объекта
<b>XMLHttpRequest</b>
.
Алфавитный указатель
Убран
...
