FileReader读取文件必须异步,onload后才能访问result;需监听onerror处理错误;大文件优先用readAsArrayBuffer()+TextDecoder;files属性只读且不可伪造;多文件需multiple属性;accept仅提示,后端须校验;JSON/CSV需手动解析;Safari旧版对编码参数支持有限;应先校验MIME类型再解析。

FileReader 读取上传文件内容必须用异步方式
浏览器环境无法同步读取用户选择的文件,FileReader 所有读取方法(如 readAsText()、readAsArrayBuffer())都是异步的,回调或 Promise 是唯一可靠路径。直接在 readAsText() 后立即访问 result 会得到 undefined。
- 必须监听
onload或使用Promise封装,等事件触发后再处理数据 -
onerror一定要监听,常见错误包括文件过大、编码不支持、用户取消读取 - 读取大文件时避免用
readAsText()—— 它会把整个文件转成字符串并载入内存,容易卡死;优先考虑readAsArrayBuffer()+TextDecoder
const input = document.querySelector('input[type="file"]');
input.addEventListener('change', (e) => {
const file = e.target.files[0];
if (!file) return;
const reader = new FileReader();
reader.onload = () => {
console.log('文件内容:', reader.result); // ✅ 此时才有值
};
reader.onerror = () => {
console.error('读取失败:', reader.error?.message);
};
reader.readAsText(file, 'UTF-8'); // 指定编码防乱码
});
input[type="file"] 的 files 属性只读且不可伪造
用户必须真实触发文件选择(点击或拖放),event.target.files 才会有内容。JS 无法通过赋值 files 属性来“注入”文件,也无法用 new File() 创建后塞进 files 列表 —— 浏览器会拒绝,且该属性是只读的 FileList 对象。
- 测试时不能靠
input.files = [...]模拟,得用真实交互或单元测试中 mockFileList - 多文件上传需设
multiple属性: - 限制类型用
accept,比如accept=".csv,.xlsx",但仅作提示,后端仍需校验
读取 CSV 或 JSON 文件要自己解析,没有内置 parser
JavaScript 不提供 parseCSV() 或 parseJSONFromFile() 这类函数。读到字符串后,必须手动处理:
- JSON 文件:确保内容是合法 JSON,再用
JSON.parse();否则会抛SyntaxError - CSV 文件:简单逗号分隔可用
split(','),但含换行、引号、逗号的字段必须用专业库(如PapaParse)或手写状态机 - 二进制文件(如图片、PDF):用
readAsArrayBuffer(),再根据 MIME 类型决定后续处理(例如用URL.createObjectURL()预览图片)
// 读取并解析 JSON 文件示例
reader.onload = () => {
try {
const data = JSON.parse(reader.result);
console.log('解析成功:', data);
} catch (err) {
console.error('JSON 格式错误:', err.message);
}
};
File API 在 Safari 和旧版 Edge 中有兼容性细节
FileReader 主流支持良好,但部分行为存在差异:
立即学习“Java免费学习笔记(深入)”;
- Safari 对
readAsText()的编码参数支持较晚(iOS 14.5+、macOS 11.3+ 才稳定支持'UTF-8'第二参数),低版本建议省略或 fallback 到readAsArrayBuffer()+TextDecoder - IE10+ 支持
FileReader,但 IE11 不支持Promise版本,需用回调 -
File.name和File.size始终可用,但File.lastModified在某些 Android WebView 中可能不准
JSON.parse() 一调就崩。先看 file.type,再结合内容嗅探(比如前 100 字符是否含 {),比盲目解析更稳妥。











