webkitdirectory 是 Chrome/Edge/Safari 16.4+ 支持的非标准布尔属性,需配合 type="file"、directory 和 multiple 使用,才能触发文件夹选择并获取含 webkitRelativePath 的扁平化 FileList,Firefox 不支持。

用 webkitdirectory 和 directory 属性选中整个文件夹
浏览器原生支持文件夹上传,但必须用对属性——webkitdirectory(Chrome/Edge)和 directory(Firefox)要同时写,只写一个会导致部分浏览器失效。仅靠 multiple 不行,它只能多选文件,不能递归读取子目录。
常见错误是把 放在普通表单里直接提交,这样后端收不到路径信息;正确做法是用 JavaScript 拿到 e.target.files,里面每个 File 对象都带 webkitRelativePath(Chrome/Edge)或 relativePath(Firefox 117+),这是保留目录结构的关键。
- macOS 用户拖入文件夹时可能带
__MACOSX/隐藏目录,需过滤:if (file.webkitRelativePath.includes('__MACOSX')) continue - Safari 目前不支持文件夹上传,得降级提示用户手动压缩 ZIP 或用其他浏览器
- IE 完全不支持,无需兼容
计算总大小和已上传量才能推算剩余时间
显示“剩余时间”不是魔法,本质是:实时上传速率 × 剩余字节数 ÷ 当前速率。难点在于「总大小」必须提前算准——不能只加 files[i].size,因为同一文件夹下可能有同名文件被覆盖,或符号链接未展开;稳妥做法是遍历所有 File 对象累加 .size,并缓存为 totalSize。
上传过程中,XMLHttpRequest 的 upload.onprogress 会触发多次,每次拿到 event.loaded(已传字节数)。但注意:event.total 在分片上传或服务端代理(如 Nginx)存在时可能不准,所以推荐用预计算的 totalSize 做分母。
- 别用
fetch()+onprogress:原生fetch不暴露上传进度,必须用XMLHttpRequest - 多个文件并发上传时,
totalSize是全部文件之和,但loaded是当前请求已传量,需维护全局计数器汇总 - 首秒速率波动大,建议等上传 500ms 后再开始估算,避免“剩余时间:0.2 秒”这种误导
XMLHttpRequest.upload.onprogress 中实时更新剩余时间
核心逻辑就三步:记录起始时间 → 每次 progress 拿到已传量 → 用(总大小 − 已传量)÷ 当前速率算剩余秒数。速率不是平均速率,而是滑动窗口内最近 3 次的加权平均,防抖动。
示例关键片段:
剩余 ${mins}分${secs}秒
-
e.loaded在某些旧版 Edge 中可能为 0,需 fallback 到累计计数逻辑 - 如果后端用分片上传(比如每片 4MB),
totalSize要按分片总数 × 片大小算,而非原始文件大小 - 用户切到其他标签页时,JavaScript 可能节流,导致速率计算偏高,可监听
visibilitychange暂停更新
机械制造场景下特别要注意的路径与并发问题
机械行业上传 BOM/CAD 文件夹,常含数百个 .dwg、.step、.pdf,单文件体积大、数量多。这时候 webkitRelativePath 的斜杠方向(/ 还是 \)和服务端路径拼接逻辑必须一致,否则解压后目录错乱。
更关键的是并发控制——浏览器默认对同一域名并发请求数有限制(Chrome 是 6 个),若一次性发 200 个 XMLHttpRequest,大量请求会排队,表面看“上传中”,实际卡在连接等待。必须做并发限制(比如最多 4 个并发),用队列 + Promise 控制。
- 不要信任
file.webkitRelativePath的根目录名,它可能是空字符串或"./",统一用pathSegments.filter(Boolean)清洗 - 后端接收时若用 Node.js + multer,需配置
limits.files和limits.fieldSize,否则大文件夹直接 413 错误 - 用户中途关闭页面,
beforeunload里无法取消正在上传的 xhr,只能靠后端断点续传接口兜底
真实项目里,“剩余时间”最常出问题的地方不在算法,而在于没处理好浏览器差异带来的路径丢失、并发阻塞、以及用户切页导致的速率失真。这些细节不修,再准的公式也显示不准。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











