XMLHttpRequestUpload:错误事件
注意:此功能在 Web Workers 中可用,但 Service Workers 除外。
当请求遇到错误时,将触发 error
事件。
语法
在诸如 addEventListener()
之类的方法中使用事件名称,或设置事件处理程序属性。
js
addEventListener("error", (event) => {});
onerror = (event) => {};
事件类型
一个 ProgressEvent
。继承自 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 表格仅在浏览器中加载