大网数据广告活动
Web 标准与前端开发

ProgressEvent

· 52CE 我爱测

`ProgressEvent`** 接口是测量如 HTTP 请求(一个`XMLHttpRequest`,或者一个 img,audio,video,style 或 link 等底层资源的加载)等底层流程进度的事件。

XMLHttpRequest API

ProgressEvent 接口是测量如 HTTP 请求(一个XMLHttpRequest,或者一个 img,audio,video,style 或 link 等底层资源的加载)等底层流程进度的事件。

构造方法

  • ProgressEvent.ProgressEvent
    • : 用给定的参数创建一个 ProgressEvent 事件。

属性

同时继承它的父元素 Event 的属性。

  • ProgressEvent.lengthComputable
    • : 是一个 Boolean 标志,表示底层流程将需要完成的总工作量和已经完成的工作量是否可以计算。换句话说,它告诉我们进度是否可以被测量。
  • ProgressEvent.loaded
    • : 是一个 unsigned long long 类型数据,表示底层流程已经执行的工作总量。可以用这个属性和 ProgressEvent.total 计算工作完成比例。当使用 HTTP 下载资源,它只表示内容本身的部分,不包括首部和其他开销。
  • ProgressEvent.total
    • : 是一个 unsigned long long 类型数据,表示正在执行的底层流程的工作总量。当使用 HTTP 下载资源,它只表示内容本身的部分,不包括首部和其他开销。

方法

同时继承它的父元素 Event 的方法。

  • ProgressEvent.initProgressEvent()
    • : 使用被弃用的 Document.createEvent() 方法,来初始化一个已经创建好的 ProgressEvent。

示例

下面的示例为一个新建的 XMLHTTPRequest 添加了一个 ProgressEvent,并使用它来显示请求状态。

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

规范

浏览器兼容性

相关链接

  • The Event base interface.

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。