ProgressEvent()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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 对象。

规范

Specification
XMLHttpRequest Standard
# dom-progressevent-progressevent

浏览器兼容性

BCD tables only load in the browser

参见