JavaScript FileReader 读取本地文件方法

本文深入介绍了浏览器原生的FileReader API，它让前端开发者能够安全、异步地读取用户主动选择的本地文件内容——无论是文本解析、CSV预处理、JSON校验，还是图片即时预览、二进制文件（如PDF、音频）处理，都无需上传服务器即可完成。文章通过清晰的步骤拆解、实用代码示例（含文本读取与图片预览）以及关键注意事项（如错误处理、性能提醒和安全限制），帮助开发者快速掌握这一提升用户体验的核心技能。

在前端开发中，有时需要让用户选择本地文件并读取其内容，比如上传前预览文本、图片或 CSV 文件。JavaScript 提供了 FileReader API 来实现对本地文件的异步读取，而无需将文件发送到服务器。

FileReader 是什么？

FileReader 是浏览器提供的 Web API，用于读取 File 或 Blob 对象的内容。它支持多种格式输出，如文本、Data URL（base64）、ArrayBuffer 等。

通常结合 <input type="file"> 使用，用户选择文件后，通过 FileReader 读取内容并展示或处理。

基本使用步骤

以下是使用 FileReader 读取本地文件的基本流程：

• 创建一个文件输入控件供用户选择文件
• 监听文件选择事件，获取 File 对象
• 创建 FileReader 实例
• 调用读取方法并监听 onload 事件获取结果

示例：读取文本文件内容

<input type="file" id="fileInput" />
<pre id="output">

常用的读取方法

FileReader 提供了几个不同的读取方式，根据文件类型选择合适的方法：

• readAsText(file, encoding)：将文件读取为纯文本。常用于 .txt、.csv、.json 等文本文件
• readAsDataURL(file)：将文件读取为 Data URL（base64 编码），适合图片预览
• readAsArrayBuffer(file)：以 ArrayBuffer 形式读取，适用于二进制文件如 PDF、音频、视频等
• readAsBinaryString(file)：读取二进制字符串（较少使用）

示例：预览本地图片

<input type="file" accept="image/*" />
<img id="preview" src="" style="max-width: 300px;" />

<script>
document.querySelector('input[type="file"]').addEventListener('change', function(e) {
  const file = e.target.files[0];
  if (!file || !file.type.match('image/')) return;

  const reader = new FileReader();

  reader.onload = function(event) {
    document.getElementById('preview').src = event.target.result;
  };

  reader.readAsDataURL(file);
});
</script>

错误处理与注意事项

读取文件过程中可能发生错误，例如文件过大、权限问题等，可以通过监听 onerror 事件捕获异常。

reader.onerror = function() {
  console.error('文件读取失败:', reader.error);
};

注意点：

• FileReader 是异步操作，不能同步获取结果
• 只能读取用户主动选择的文件，无法访问任意本地路径
• 大文件读取可能影响性能，尤其是转为 base64 时
• 兼容性良好，现代浏览器均支持 FileReader

基本上就这些。掌握 FileReader 可以让你在前端灵活处理本地文件内容，提升用户体验。

本篇关于《JavaScript FileReader 读取本地文件方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！