必须同时加webkitdirectory和directory属性,缺一不可;还需强制添加multiple,正确写法为,否则浏览器无法正确触发文件夹选择并获取完整子文件列表。

怎么用 <input> 选中整个文件夹
必须加 webkitdirectory 和 directory 两个属性,缺一不可。只写 webkitdirectory 在 Firefox 里会失效;只写 directory 在 Chrome/Edge 里不识别。
正确写法:
<input type="file" id="folderInput" webkitdirectory directory multiple>
注意:multiple 不是可选的——即使只选一个文件夹,也得带上它,否则部分浏览器(如旧版 Edge)可能只返回根目录下的文件,忽略子目录。
- 不支持 IE 及任何版本的 Safari(截至 2026 年 11 月仍无原生支持)
- macOS 用户选文件夹时,
.DS_Store和__MACOSX会混进files列表,需手动过滤 -
event.target.files是只读的FileList,不能用Array.from()直接遍历再filter,得先转成数组再处理
怎么拿到每个文件的相对路径并计时
File 对象自带 webkitRelativePath 属性,它就是从你选中的文件夹根开始的完整路径(比如 "图纸/装配图.dwg")。这个字段在所有支持文件夹上传的浏览器里都可用,不需要额外 polyfill。
立即学习“前端免费学习笔记(深入)”;
计时必须包裹整个上传流程:从用户点击“上传”按钮开始,到所有 XMLHttpRequest 的 load 事件全部触发结束。不能只测单个请求,也不能只测前端打包时间。
- 别用
Date.now()粗略相减——要监听XMLHttpRequest.upload.onprogress和onload,用performance.now()更准 - 上传前记得检查
file.webkitRelativePath是否为空,空值代表该File是文件夹本身(某些浏览器会把文件夹当“伪文件”塞进来) - 大文件夹(>200 个文件)建议分批上传,否则容易触发浏览器内存警告或卡死主线程
怎么发请求并打印总耗时到控制台
核心逻辑是:收集所有 File,为每个构造带路径信息的 FormData,并发发送(但要限制并发数,比如最多 4 个),最后等全部完成再算总耗时。
示例关键片段:
const start = performance.now();<br>const uploads = Array.from(files)<br> .filter(f => f.webkitRelativePath)<br> .map(file => {<br> const formData = new FormData();<br> formData.append('file', file);<br> formData.append('path', file.webkitRelativePath); // 后端靠这个重建目录<br> return uploadOne(formData); // 返回 Promise<XMLHttpRequest><br> });<br><br>Promise.all(uploads).then(() => {<br> const end = performance.now();<br> console.log(`文件夹上传完成,总耗时:${(end - start).toFixed(1)}ms`);<br>});-
uploadOne函数里必须用XMLHttpRequest(不是fetch),因为只有它能监听上传进度和准确捕获load事件 - 后端必须能接收
path字段,并按此路径在服务器上创建对应子目录,否则“保持结构”就只是空话 - 如果某次上传失败,
Promise.all会直接 reject,需要改用Promise.allSettled并单独统计成功/失败数
为什么控制台有时只打出一半耗时就结束了
常见原因是没正确 await 所有异步操作,或者把计时起点放在了 change 事件里(用户选完还没点上传),又或者忘了 event.preventDefault() 导致表单默认提交刷新页面。
- 最隐蔽的坑:Chrome DevTools 的 Console 默认勾选了 “Preserve log”,但如果你没勾,页面一刷新日志就清空,看起来就像“没打印”
- 另一个高频问题:上传过程中用户切到别的 tab,Chrome 会节流
XMLHttpRequest,导致实际耗时远大于控制台显示值 - 真实生产环境里,还要考虑网络抖动、服务端排队、磁盘 I/O 延迟——控制台打出来的只是前端视角的“发起到收包”时间,不是端到端真实耗时



















