FileReader：load 事件

注意：此功能在Web Workers中可用。

FileReader 接口的load 事件在文件已成功读取时触发。

此事件不可取消，也不冒泡。

语法

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

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

onload = (event) => {};

事件类型

一个 ProgressEvent。继承自 Event。

Event ProgressEvent

事件属性

还继承了其父级 Event 的属性.

ProgressEvent.lengthComputable 只读

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

ProgressEvent.loaded 只读

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

ProgressEvent.total 只读

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

示例

实时示例

HTML

html
<div class="example">
  <div class="file-select">
    <label for="avatar">Choose a profile picture:</label>
    <input
      type="file"
      id="avatar"
      name="avatar"
      accept="image/png, image/jpeg" />
  </div>

  <img src="" class="preview" height="200" alt="Image preview" />

  <div class="event-log">
    <label for="eventLog">Event log:</label>
    <textarea readonly class="event-log-contents" id="eventLog"></textarea>
  </div>
</div>

JavaScript

js
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} bytes transferred\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);
  }
}

fileInput.addEventListener("change", handleSelected);

结果

规范

规范
文件 API
# dfn-load-event
文件 API
# dfn-onload

浏览器兼容性

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

另请参阅