大网数据广告活动
Web 标准与前端开发

FileReader:abort 事件

· 52CE 我爱测

FileReader 接口的 **`abort`** 事件在读取被中止时触发:例如因为程序调用了 FileReader.abort() 方法。

File API

FileReader 接口的 abort 事件在读取被中止时触发:例如因为程序调用了 FileReader.abort() 方法。

此事件不可取消且不会冒泡。

语法

在 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。

addEventListener("abort", (event) => {});

onabort = (event) => {};

事件类型

ProgressEvent。继承自 Event。

ProgressEvent

事件属性

还继承其父级 Event 的属性。

  • ProgressEvent.lengthComputable
    • : 一个布尔标志,指示底层进程要完成的总工作量以及已完成的工作量是否可计算。换句话说,它表明进展是否可衡量。
  • ProgressEvent.loaded
    • : 一个 64 位无符号整数值,指示底层进程已执行的工作量。完成工作的比率可以通过将 total 除以该属性的值来计算。使用 HTTP 下载资源时,仅计算 HTTP 消息的正文,不包括标头和其他开销。
  • ProgressEvent.total
    • : 一个 64 位无符号整数,表示底层进程正在执行的工作总量。使用 HTTP 下载资源时,这是 Content-Length(消息正文的大小),不包括标头和其他开销。

示例

实时示例

HTML

<div class="example">
  <div class="file-select">
    <label for="avatar">选择个人资料图片:</label>
    <input
      type="file"
      id="avatar"
      name="avatar"
      accept="image/png, image/jpeg" />
  </div>

  <img src="" class="preview" height="200" alt="图片预览" />

  <div class="event-log">
    <label for="eventLog">事件日志:</label>
    <textarea readonly class="event-log-contents" id="eventLog"></textarea>
  </div>
</div>
img.preview {
  margin: 1rem 0;
}

.event-log-contents {
  width: 18rem;
  height: 5rem;
  border: 1px solid black;
  margin: 0.2rem;
  padding: 0.2rem;
  resize: none;
}

.example {
  display: grid;
  grid-template-areas:
    "select  log"
    "preview log";
}

.file-select {
  grid-area: select;
}

.preview {
  grid-area: preview;
}

.event-log {
  grid-area: log;
}

.event-log > label {
  display: block;
}

JavaScript

const fileInput = document.querySelector('input[type="file"]');
const preview = document.querySelector("img.preview");
const eventLog = document.querySelector(".event-log-contents");
const reader = new FileReader();

function handleEvent(event) {
  eventLog.textContent += `${event.type}:传输了 ${event.loaded} 字节\n`;

  if (event.type === "load") {
    preview.src = reader.result;
  }
}

function addListeners(reader) {
  reader.addEventListener("loadstart", handleEvent);
  reader.addEventListener("load", handleEvent);
  reader.addEventListener("loadend", handleEvent);
  reader.addEventListener("progress", handleEvent);
  reader.addEventListener("error", handleEvent);
  reader.addEventListener("abort", handleEvent);
}

function handleSelected(e) {
  eventLog.textContent = "";
  const selectedFile = fileInput.files[0];
  if (selectedFile) {
    addListeners(reader);
    reader.readAsDataURL(selectedFile);
  }
  reader.abort();
}

fileInput.addEventListener("change", handleSelected);

结果

实时示例

规范

浏览器兼容性

参见

  • 相关事件:FileReader.loadstart_event、FileReader.loadend_event、FileReader.progress_event、FileReader.error_event、FileReader.load_event

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。