此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

ProgressEvent()

基线 广泛可用 *

自 2016年8月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

* 此特性的某些部分的支持程度可能有所不同。

ProgressEvent() 构造函数返回一个新的 ProgressEvent 对象,表示当前一个漫长处理过程的完成进度。

语法

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

参数

type

带有事件名称的字符串。它是区分大小写的,浏览器将其设置为 loadstartprogressaborterrorloadtimeoutloadend

options 可选

一个对象,除了 Event() 中定义的属性,它还具有以下属性:

lengthComputable 可选

一个布尔值,表示底层的进程将要完成的总工作量和已经完成的工作量是否是可计算的。换句话说,它说明进度是否可衡量。它的默认值是 false

loaded 可选

一个数值,表示底层的进程已经完成的工作量。可以使用该属性和 ProgressEvent.total 计算完成工作的比例。当使用 HTTP 下载一个资源时,其仅表示内容本身(body)的部分,不包含头和其他开销。它默认值为 0

total 可选

一个数值,表示底层的进程正在进行的工作的总工作量。当使用 HTTP 下载一个资源时,其仅表示内容本身(body)的部分,不包含头和其他开销。它默认值为 0

返回值

一个新的 ProgressEvent 对象。

规范

规范
XMLHttpRequest
# dom-progressevent-progressevent

浏览器兼容性

参见