FileReader读取文件必须异步,onload后才能访问result;需监听onerror处理错误;大文件优先用readAsArrayBuffer()+TextDecoder;files属性只读且不可伪造;多文件需multiple属性;accept仅提示,后端须校验;JSON/CSV需手动解析;Safari旧版对编码参数支持有限;应先校验MIME类型再解析。
浏览器环境无法同步读取用户选择的文件,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'); // 指定编码防乱码
});
用户必须真实触发文件选择(点击或拖放),event.target.files 才会有内容。JS 无法通过赋值 files 属性来“注入”文件,也无法用 new File() 创建后塞进 files 列表 —— 浏览器会拒绝,且该属性是只读的 FileList 对象。
input.files = [...] 模拟,得用真实交互或单元测试中 mock FileList
multiple 属性:
accept,比如 accept=".csv,.xlsx",但仅作提示,后端仍需校验JavaScript 不提供 parseCSV() 或 parseJSONFromFile() 这类函数。读到字符串后,必须手动处理:
JSON.parse();否则会抛 SyntaxError
split(','),但含换行、引号、逗号的字段必须用专业库(如 PapaParse)或手写状态机readAsArrayBuffer(),再根据 MIME 类型决定后续处理(例如用 URL.createObjectURL() 预览图片)// 读取并解析 JSON 文件示例
reader.onload = () => {
try {
const data = JSON.parse(reader.result);
console.log('解析成功:', data);
} catch (err) {
console.error('JSON 格式错误:', err.message);
}
};
FileReader 主流支持良好,但部分行为存在差异:
readAsText() 的编码参数支持较晚(iOS 14.5+、macOS 11.3+ 才稳定支持 'UTF-8' 第二参数),低版本建议省略或 fallback 到 readAsArrayBuffe
r() + TextDecoder
FileReader,但 IE11 不支持 Promise 版本,需用回调File.name 和 File.size 始终可用,但 File.lastModified 在某些 Android WebView 中可能不准JSON.parse() 一调就崩。先看 file.type,再结合内容嗅探(比如前 100 字符是否含 {),比盲目解析更稳妥。