File对象的name和size属性可在drop事件中通过e.dataTransfer.files[0]安全读取,name为原始文件名(不含路径),size为字节数;须在dragover和drop事件中均调用preventDefault()以确保files可用。

拖拽文件时如何读取 File 对象的名称和大小
拖拽进浏览器的文件在事件中是以 File 对象形式存在的,它继承自 Blob,天然具备 name 和 size 属性。关键不是“怎么获取”,而是“在哪一刻能安全访问”——必须等 drop 事件触发后,从 event.dataTransfer.files 中取,不能依赖 input[type="file"] 的 change 事件。
常见错误是直接监听 dragover 就去读 files,但此时 dataTransfer.files 还为空;或者误用 event.target.files(拖拽场景下该属性无意义)。
-
event.dataTransfer.files是一个FileList,可用[0]取第一个文件,或遍历 -
file.name是字符串,含原始文件名(可能带路径,但浏览器已自动剥离,只留 basename) -
file.size是数字,单位为字节,不是 KB 或 MB - 注意兼容性:
File对象在 IE10+ 支持,但 IE 不支持拖拽 API,实际需搭配input回退
drop 事件里取不到 files?检查这三件事
明明拖进来了却读到空数组,大概率是阻止默认行为没做对。拖拽文件进页面时,浏览器默认会尝试打开或下载该文件,不阻止就会跳转/刷新,drop 事件甚至不会触发。
- 必须在
dragover和drop两个事件中都调用event.preventDefault() -
dragover事件还需设置event.dataTransfer.dropEffect = "copy"(否则部分浏览器显示“禁止”图标) - 确保监听的是目标容器(如
div#drop-area),而不是document全局——如果容器没有宽高或display: none,事件根本不会命中
示例片段:
const dropArea = document.getElementById('drop-area');
dropArea.addEventListener('dragover', (e) => {
e.preventDefault();
e.dataTransfer.dropEffect = 'copy';
});
dropArea.addEventListener('drop', (e) => {
e.preventDefault();
const files = e.dataTransfer.files; // ✅ 此时才可安全读取
if (files.length > 0) {
console.log(files[0].name, files[0].size); // 如:'report.pdf', 2048567
}
});
为什么 file.name 有时是乱码或截断?
这不是 JS 的问题,而是浏览器对非 ASCII 文件名的处理差异。Chrome / Edge 在大多数情况下能正确还原 UTF-8 文件名;Firefox 在某些系统(如旧版 macOS)下可能将中文名转成形如 "=UTF-8'B...'" 的编码格式(MIME encoded-word),但现代版本已基本修复。
真正要注意的是:用户可能上传同名文件(如多次拖拽 “未命名.png”),而 File.name 不包含路径,无法区分来源。若需唯一标识,应结合 file.lastModified 或计算 file 的 hash(需用 FileReader 读取二进制内容,开销较大)。
- 不要依赖
file.name做服务端存储路径,应由后端生成唯一文件名 - 前端仅用
name做 UI 展示(如“你选择了:xxx”),展示前可简单过滤控制字符:file.name.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '') -
file.size绝对可信,但不代表最终上传体积(压缩、加密、分块上传都会改变)
想同时获取多个文件的名称和大小?别用 for…in
FileList 不是数组,是类数组对象,没有 map、forEach 方法。直接用 for (let i = 0; i 最稳妥,或转成数组再操作。
- 推荐转数组:
Array.from(files).map(f => ({ name: f.name, size: f.size })) - 避免
for…in:它会遍历原型链上的属性(如length、item),导致意外结果 - 注意性能:如果一次拖拽上百个文件,
FileList本身只是引用,不占内存;但立刻读取每个file.size是同步且廉价的,无需防抖
复杂点在于:用户可能拖入文件夹(Chrome 支持,Firefox 不支持),这时需要检测 file.webkitRelativePath 或用 webkitGetAsEntry 递归读取——但那是另一个问题了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











