XMLHttpRequest.upload

XMLHttpRequestupload プロパティは、アップロードの進捗を監視することができる XMLHttpRequestUpload オブジェクトを返します。これは不透過なオブジェクトですが、 XMLHttpRequestEventTarget でもあるため、進捗を追跡するために添付することができます。

以下のイベントは upload オブジェクトを起動してアップロードを監視する目に使用することができます。

イベント イベントリスナー 解説
loadstart onloadstart アップロードが始まった。
progress onprogress 進捗の量を示すために定期的に発生する。
abort onabort アップロード操作が中断された。
error onerror アップロードがエラーのために失敗した。
load onload アップロードが完全に成功した。
timeout ontimeout 返事が XMLHttpRequest.timeout で指定された時間間隔内に届かなかったため、アップロードがタイムアウトされた。
loadend onloadend アップロードが終了した。このイベントでは成功か失敗かを区別することはできず、結果にかかわらずアップロードが終了したときに送信されます。このイベントの前に、 load, error, abort, timeout のうちの1つがアップロードが終了した理由を示すために配信されます。

仕様書

仕様書 状態 備考
XMLHttpRequest 現行の標準 WHATWG living standard

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
uploadChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 ありIE 完全対応 10Opera 完全対応 ありSafari 完全対応 10WebView Android 完全対応 ありChrome Android 完全対応 18Firefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 1.0

凡例

完全対応  
完全対応

関連情報