ProgressEvent

ProgressEvent()

使用给定的参数创建一个 ProgressEvent 事件。

还继承了其父级 Event 的属性.

ProgressEvent.lengthComputable 只读

一个布尔标志，指示是否可以计算已传输或处理的数据大小 (loaded) 与数据总大小 (total) 之间的比率。换句话说，它指示进度是否可衡量。

ProgressEvent.loaded 只读

一个 64 位无符号整数，指示已传输或处理的数据大小（以字节为单位）。可以通过将 ProgressEvent.total 除以此属性的值来计算比率。在使用 HTTP 下载资源时，这仅计算 HTTP 消息的主体，不包括标头和其他开销。请注意，对于总大小未知的压缩请求，loaded 可能包含压缩数据或解压缩数据的大小，具体取决于浏览器。截至 2024 年，它在 Firefox 中包含压缩数据的大小，在 Chrome 中包含未压缩数据的大小。

ProgressEvent.total 只读

一个 64 位无符号整数，指示正在传输或处理的数据的总大小（以字节为单位）。在使用 HTTP 下载资源时，此值取自 Content-Length 响应标头。它仅计算 HTTP 消息的主体，不包括标头和其他开销。

继承了其父级 Event 的方法。

以下示例将 ProgressEvent 添加到新的 XMLHTTPRequest 并使用它来显示请求的状态。

const progressBar = document.getElementById("p"),
  client = new XMLHttpRequest();
client.open("GET", "magical-unicorns");
client.onprogress = (pe) => {
  if (pe.lengthComputable) {
    progressBar.max = pe.total;
    progressBar.value = pe.loaded;
  }
};
client.onloadend = (pe) => {
  progressBar.value = pe.loaded;
};
client.send();

• Event 基本接口。