XMLHttpRequestUpload:错误事件

基线 广泛可用

此功能已得到良好建立,并在许多设备和浏览器版本上运行。它已在浏览器中可用,自 2015 年 7 月.

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

当请求遇到错误时,将触发 error 事件。

语法

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

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

onerror = (event) => {};

事件类型

事件属性

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

lengthComputable 只读

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

loaded 只读

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

total 只读

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

示例

使用 error 事件

您可以使用 error 事件来检测上传时出现的问题。有关上传文件并显示进度条的完整代码示例,请参见主 XMLHttpRequestUpload 页面。

js
// In case of an error 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("error", errorAction);

规范

规范
XMLHttpRequest 标准
# event-xhr-error
XMLHttpRequest 标准
# handler-xhr-onerror

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅