W3cubDocs

/DOM

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:

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.

Specifications

Specification Status Comment
XMLHttpRequest Living Standard WHATWG living standard

Browser compatibilityUpdate compatibility data on GitHub

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

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/upload