直接拖拽文件夹需用 event.dataTransfer.items 而非 files,因 files 仅返回顶层伪文件且 size 为 0;items 中的 DataTransferItem 调用 webkitGetAsEntry() 才能递归访问目录树,注意兼容性与路径安全校验。

直接拖拽文件夹到网页是可行的,但必须用 event.dataTransfer.items 而不是 event.dataTransfer.files,否则只会拿到空列表或报错。
为什么 files 拿不到文件夹里的内容
浏览器对拖拽文件夹做了特殊处理:event.dataTransfer.files 只暴露顶层“伪文件”(比如一个叫 my-folder/ 的条目),实际子文件被藏在 items 里。不走 items + webkitGetAsEntry() 这条路,就根本进不去目录树。
-
files.length可能为 1,但files[0].name是文件夹名,files[0].size是 0,无法递归 -
items才包含真正的DataTransferItem,每个 item 可能是文件或目录入口 - 只有调用
item.webkitGetAsEntry()并判断isDirectory === true,才能启动递归扫描
如何用 items 正确读取整个文件夹
核心是把每个 DataTransferItem 转成 FileSystemEntry,再用 createReader().readEntries() 展开。注意:这个 API 在 Safari 中直到 iOS 16.4 才支持,桌面端 Chrome/Firefox/Edge 均可用。
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
- 遍历
e.dataTransfer.items,对每个item调用item.webkitGetAsEntry() - 若返回 entry 且
entry.isDirectory为 true,用entry.createReader().readEntries()获取子项 - 递归处理子项——不能用
for...of同步遍历,必须用async/await或 Promise 链,因为readEntries是异步的 - 别漏掉
entry.isFile === true的情况,此时直接entry.file(callback)提取File对象
路径信息怎么保留:别信 file.webkitRelativePath
这个属性只在 <input type="file" webkitdirectory> 场景下可靠;拖拽文件夹时,它基本为空或不可靠。真实路径只能靠递归过程中拼接 entry.fullPath(如 "/my-folder/sub/img.png")来重建。
立即学习“前端免费学习笔记(深入)”;
-
entry.fullPath是相对根目录的路径,开头带/,需手动去掉或标准化 - 拼路径时用
path.join(root, entry.fullPath)(Node.js)或root + entry.fullPath.replace(/^\/+/, '')(浏览器) - 后端接收时,要校验路径是否越界(如防止
../../../etc/passwd),建议用白名单前缀过滤
常见卡点和兼容性兜底策略
最常被忽略的是移动端完全不支持拖拽文件夹——iOS Safari 直到 16.4 才开放 webkitGetAsEntry,Android WebView 则基本没戏。用户真拖了文件夹进来,你得立刻 fallback 到点击上传提示。
- 先检查
typeof DataTransferItem.prototype.webkitGetAsEntry === 'function',不满足就禁用拖拽文件夹逻辑 - 检测到
items中有kind === 'file'但webkitGetAsEntry返回 null,说明是单文件拖拽,走files流程 - 拖拽区域上显示两行提示:“拖拽文件夹(仅桌面浏览器)” + “或点击选择文件/文件夹”
- 不要在
dragover里做递归预检——它高频触发,容易卡死,只做视觉反馈即可


















