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

ブラウザーの互換性

BCD tables only load in the browser

関連情報