XMLHttpRequestUpload:loadstart 事件

基线 广泛可用

此功能已得到广泛使用,并且可在许多设备和浏览器版本上运行。它自以下时间起在所有浏览器中都可用: 2015 年 7 月.

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

loadstart 事件在请求开始加载数据时触发。

语法

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

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

onloadstart = (event) => {};

事件类型

事件属性

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

lengthComputable 只读

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

loaded 只读

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

total 只读

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

示例

使用 loadstart 事件

您可以使用 loadstart 事件检测上传的开始。有关上传文件并显示进度条的完整代码示例,请参阅主 XMLHttpRequestUpload 页面。

js
// When the upload starts, we display the progress bar
xhr.upload.addEventListener("loadstart", (event) => {
  progressBar.classList.add("visible");
  progressBar.value = 0;
  progressBar.max = event.total;
  log.textContent = "Uploading (0%)…";
  abortButton.disabled = false;
});

规范

规范
XMLHttpRequest 标准
# event-xhr-loadstart
XMLHttpRequest 标准
# handler-xhr-onloadstart

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅