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:

Event Event listener Description
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.


Specification Status Comment
XMLHttpRequest Living Standard WHATWG living standard

Browser compatibility

Update compatibility data on GitHub
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 1Edge Full support 12Firefox Full support YesIE ? Opera Full support YesSafari Full support 10WebView Android Full support YesChrome Android Full support 18Edge Mobile ? Firefox Android ? Opera Android Full support YesSafari iOS ? Samsung Internet Android Full support Yes


Full support  
Full support
Compatibility unknown  
Compatibility unknown

See also