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