drop事件中通过event.dataTransfer.files获取FileList,它是唯一可靠入口;需先判空再转为数组(如Array.from)才能遍历,不可直接map或forEach,且不能误写为event.dataTransfer.file。

drop 事件里怎么拿到原始文件对象
拖拽释放后,event.dataTransfer.files 是唯一可靠入口,它返回的是 FileList(类数组),不是普通数组,不能直接用 map 或 forEach(除非转成数组)。常见错误是误写成 event.dataTransfer.file(少 s)或试图从 getData() 读文件——那只能传字符串,不存二进制内容。
实操建议:
- 先检查
files.length > 0,空列表说明没拖进来东西 - 遍历用
for (let i = 0; i 最稳;或用Array.from(files)转成真数组再forEach -
files[0]是一个File实例,它继承自Blob,天然支持stream()、arrayBuffer()、text()等方法
File.stream() 返回的是什么流
File.stream() 返回的是标准 ReadableStream,不是 Node.js 的 fs.ReadStream,也不能直接 pipe 到后端。它是浏览器原生的流式读取接口,适合大文件分块处理或边读边传,但需要配合 Response、fetch 或 TransformStream 使用。
注意点:
- 流一旦被读取(如调用
getReader()并read()),该File对象就不可重复读取——后续再调arrayBuffer()会报错 - 如果只是上传,通常不需要手动调
stream(),直接把File实例塞进FormData.append()更简单,浏览器自动处理底层流 - 真要用流(比如计算哈希、预检内容、断点续传),得用
const reader = file.stream().getReader(),然后循环reader.read()拿{ done, value }
怎么把 File 转成 ArrayBuffer 或 Uint8Array
这是最常用来做前端校验、加密或离线处理的操作。核心是用 file.arrayBuffer()(返回 Promise),不是 FileReader —— 后者是旧 API,冗余且难控制。
示例代码片段:
file.arrayBuffer().then(buffer => {
const uint8 = new Uint8Array(buffer);
console.log('前 4 字节:', uint8.slice(0, 4));
});
关键提醒:
-
arrayBuffer()会把整个文件加载进内存,超大文件(>500MB)可能触发 OOM,此时必须用stream()分块读 - 不要在
dragstart或dragover里提前调用它——用户还没放,没必要提前占内存 - 若需兼容 IE11,只能退回
FileReader,但 IE11 不支持stream()和arrayBuffer()
为什么 FileReader.readAsArrayBuffer() 还有人用
因为部分场景下它比 arrayBuffer() 方法更可控:比如你想在读取中途 abort,或监听进度(onprogress),FileReader 仍不可替代。但它和 File.stream() 是两条路,别混用。
典型误用:
- 用
readAsArrayBuffer()读完后,又去调file.arrayBuffer()→ 报错“Failed to execute 'arrayBuffer' on 'Blob': Blob is already being read” - 在
onload外访问reader.result→ 是undefined,必须等回调触发 - 忘记在
onload里加event.target.result判断,直接解构 →undefined导致后续崩溃
真正需要流式处理或精细控制读取过程时,才值得绕开现代 Promise 方法去写 FileReader;否则,优先用 file.arrayBuffer() 或直接丢给 FormData。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











