XMLHttpRequest.upload

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

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

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

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報