XMLHttpRequestUpload: load 事件

基线 广泛可用

此功能已得到完善，可在许多设备和浏览器版本上运行。它自以下时间起在各个浏览器中可用： 2015 年 7 月.

注意：此功能在 Web Workers 中可用，但 Service Workers 除外。

当 XMLHttpRequestUpload 事务成功完成时，将触发 load 事件。

语法

在诸如 addEventListener() 的方法中使用事件名称，或设置事件处理程序属性。

js
addEventListener("load", (event) => {});

onload = (event) => {};

事件类型

一个 ProgressEvent。继承自 Event。

Event ProgressEvent

事件属性

除了下面列出的属性外，父接口 Event 的属性也可使用。

lengthComputable 只读

一个布尔标志，指示基础进程要完成的工作总量以及已完成的工作量是否可计算。换句话说，它说明进度是否可衡量。

loaded 只读

一个 64 位无符号整数，指示基础进程已执行的工作量。可以通过将 total 除以此属性的值来计算已完成的工作量比率。在使用 HTTP 下载资源时，这仅计算 HTTP 消息的主体，不包括标头和其他开销。

total 只读

一个 64 位无符号整数，表示基础进程正在执行的工作总量。在使用 HTTP 下载资源时，这是 Content-Length（消息主体的尺寸），不包括标头和其他开销。

示例

使用 load 事件

您可以使用 load 事件来检测上传的成功终止。有关上传文件并显示进度条的完整代码示例，请参阅主 XMLHttpRequestUpload 页面。

js
// When the upload is finished, we hide the progress bar.
xhr.upload.addEventListener("load", (event) => {
  progressBar.classList.remove("visible");
  log.textContent = "Upload finished.";
  abortButton.disabled = true;
});

规范

规范
XMLHttpRequest 标准
# event-xhr-load
XMLHttpRequest 标准
# handler-xhr-onload

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅