XMLHttpRequestUpload:超时事件

基线 广泛可用

此功能已得到良好建立,并且在许多设备和浏览器版本上都能正常工作。它已在浏览器中提供自 2015 年 7 月.

**注意:** 此功能可在 Web 工作线程 中使用,但 服务工作线程 除外。

当进度因预设时间到期而终止时,将触发**timeout**事件。

语法

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

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

ontimeout = (event) => {};

事件类型

事件属性

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

lengthComputable 只读

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

loaded 只读

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

total 只读

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

示例

使用timeout事件

您可以使用timeout事件检测因速度过慢而停止的上传。有关上传文件并显示进度条的完整代码示例,请参阅主 XMLHttpRequestUpload 页面。

超时是在 XMLHttpRequest 对象上使用 XMLHttpRequest.timeout 属性设置的。

js
// In case of an timeout we hide the progress bar
// Note that this event can be listened to on the xhr object too
function errorAction(event) {
  progressBar.classList.remove("visible");
  log.textContent = `Upload failed: ${event.type}`;
}
xhr.upload.addEventListener("timeout", errorAction);

规范

规范
XMLHttpRequest 标准
# event-xhr-timeout
XMLHttpRequest 标准
# handler-xhr-ontimeout

浏览器兼容性

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

另请参阅