ProgressEvent: ProgressEvent() コンストラクター

Baseline 広く利用可能 *

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年8月以降、すべてのブラウザーで利用可能です。

* この機能の一部は、対応レベルが異なる場合があります。

ProgressEvent() コンストラクターは、長いプロセスの現在の完了状況を表す ProgressEvent を新しく生成して返します。

構文

new ProgressEvent(type)
new ProgressEvent(type, options)

このイベントの名前の文字列です。大文字小文字を区別し、ブラウザーは loadstart, progress, abort, error, load, timeout, loadend の何れかを設定します。

オブジェクトで、Event() で定義されているプロパティに加え、以下のプロパティを持つことができます。

lengthComputable 省略可: 論理値のフラグで、基礎となるプロセスで行われる作業の合計と、すでに行われた作業の量が計算可能であるかどうかを示します。言い換えれば、進捗が測定可能かどうかを示します。既定値は false です。
loaded 省略可: 数値で、基礎となるプロセスで既に実行された作業量を表します。行われた作業の割合は、このプロパティと ProgressEvent.total を用いて計算することができます。 HTTP を使用してリソースをダウンロードする場合、これはヘッダーやその他のオーバーヘッドではなく、コンテンツそのものの部分のみを表します。既定値は 0 です。
total 省略可: 基礎となるプロセスが実行中の作業の総量を表す数値です。 HTTP を使用してリソースをダウンロードする場合、これはヘッダーやその他のオーバーヘッドではなく、コンテンツそのものを表します。既定値は 0 です。