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 |
ブラウザーの互換性
BCD tables only load in the browser