XMLHttpRequest の upload プロパティは、アップロードの進捗を監視することができる 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 |
ブラウザーの互換性
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Update compatibility data on GitHub
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
upload | Chrome 完全対応 1 | Edge 完全対応 12 | Firefox 完全対応 あり | IE ? | Opera 完全対応 あり | Safari 完全対応 10 | WebView Android 完全対応 あり | Chrome Android 完全対応 18 | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 1.0 |
凡例
- 完全対応
- 完全対応
- 実装状況不明
- 実装状況不明