XMLHttpRequest.upload
The XMLHttpRequest
upload
property returns an XMLHttpRequestUpload
object that can be observed to monitor the progress of an upload. It is an opaque object, but being an XMLHttpRequestEventTarget
, event listeners can be set on it to track its process.
The following events can be triggered on an upload object and used to monitor the state of the upload process:
loadstart | onloadstart | The upload has begun. |
progress | onprogress | Periodically delivered to indicate the current amount of progress made so far |
abort | onabort | The upload operation was aborted. |
error | onerror | The upload failed due to an error. |
load | onload | The upload completed successfully. |
timeout | ontimeout | The upload timed out because an awaited reply did not arrive within the time interval specified by the timeout property on the XMLHttpRequest . |
loadend | onloadend | The upload completed; this event does not differentiate between success or failure, and is sent at the very end of the upload process, regardless of the outcome. Prior to this event being sent, one of load , error , abort , or timeout will already have been delivered to indicate why the upload is ending. |
Specifications
Specification | Status | Comment |
XMLHttpRequest | Living Standard | WHATWG living standard |
|
Desktop |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
Basic support |
1 |
12 |
Yes |
? |
Yes |
10 |
|
Mobile |
|
Android webview |
Chrome for Android |
Edge Mobile |
Firefox for Android |
Opera for Android |
iOS Safari |
Samsung Internet |
Basic support |
Yes |
18 |
? |
? |
Yes |
? |
Yes |
See also