XMLHttpRequest: свойство upload
Базовая поддержка Широко распространена
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Примечание: Эта функция доступна в Потоках Web Workers, за исключением Сервисных рабочих потоков.
Свойство XMLHttpRequest upload возвращает объект XMLHttpRequestUpload, который можно наблюдать для отслеживания прогресса загрузки.
Это неявный объект, но поскольку он также является XMLHttpRequestEventTarget, к нему можно прикрепить обработчики событий для отслеживания процесса.
Примечание: Прикрепление обработчиков событий к этому объекту предотвращает выполнение запроса как «простого запроса» и приведет к отправке предварительного запроса при междоменном доступе; см. CORS. Из-за этого обработчики событий необходимо зарегистрировать перед вызовом send(), иначе события загрузки не будут отправлены.
Примечание: Спецификация также предполагает, что обработчики событий следует прикреплять после open(). Однако браузеры могут быть нестабильны в этом вопросе и часто требуют регистрации обработчиков до open() для работы.
Следующие события могут быть вызваны на объекте загрузки и использованы для отслеживания загрузки:
| Событие | Описание |
|---|---|
loadstart | Загрузка началась. |
progress | Периодически отправляется для отображения пройденного прогресса. |
abort | Операция загрузки была прервана. |
error | Загрузка завершилась с ошибкой. |
load | Загрузка успешно завершена. |
timeout | Загрузка истекла по времени, так как ответ не поступил в течение указанного интервала времени параметром XMLHttpRequest.timeout. |
loadend | Загрузка завершена. Это событие не различает успех и неудачу и отправляется в конце загрузки независимо от результата. До этого события одно из load, error, abort, или timeout уже будет отправлено, чтобы указать причину завершения загрузки. |
Спецификации
| Спецификация |
|---|
| XMLHttpRequest # the-upload-attribute |
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
upload |
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/XMLHttpRequest/upload
