File API
FileReader 接口的 error 事件在由于错误(例如,因为文件未找到或不可读)导致读取失败时触发。
此事件不可取消且不会冒泡。
语法
在 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。
addEventListener("error", (event) => {});
onerror = (event) => {};
事件类型
ProgressEvent。继承自 Event。
ProgressEvent
事件属性
还继承其父级 Event 的属性。
- ProgressEvent.lengthComputable
- : 一个布尔标志,指示底层进程要完成的总工作量以及已完成的工作量是否可计算。换句话说,它表明进展是否可衡量。
- ProgressEvent.loaded
- : 一个 64 位无符号整数值,指示底层进程已执行的工作量。完成工作的比率可以通过将
total除以该属性的值来计算。使用 HTTP 下载资源时,仅计算 HTTP 消息的正文,不包括标头和其他开销。
- : 一个 64 位无符号整数值,指示底层进程已执行的工作量。完成工作的比率可以通过将
- ProgressEvent.total
- : 一个 64 位无符号整数,表示底层进程正在执行的工作总量。使用 HTTP 下载资源时,这是
Content-Length(消息正文的大小),不包括标头和其他开销。
- : 一个 64 位无符号整数,表示底层进程正在执行的工作总量。使用 HTTP 下载资源时,这是
示例
const fileInput = document.querySelector('input[type="file"]');
const reader = new FileReader();
function handleSelected(e) {
const selectedFile = fileInput.files[0];
if (selectedFile) {
reader.addEventListener("error", () => {
console.error(`读取文件时发生错误:${selectedFile.name}`);
});
reader.addEventListener("load", () => {
console.log(`文件:${selectedFile.name} 读取成功`);
});
reader.readAsDataURL(selectedFile);
}
}
fileInput.addEventListener("change", handleSelected);
规范
浏览器兼容性
参见
- 相关事件:FileReader.loadstart_event、FileReader.loadend_event、FileReader.progress_event、FileReader.load_event、FileReader.abort_event
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
