webkitRelativePath 是唯一可获文件夹结构的字段,仅当用 webkitdirectory 选整个文件夹时存在,值为相对路径片段如"project/src/index.js",不反映真实磁盘路径,Firefox 不支持。

webkitRelativePath 是唯一能从浏览器端拿到文件夹结构信息的字段,但它不是“路径”,而是相对路径片段;且仅在用户通过 webkitdirectory 属性选择整个文件夹时才存在。
为什么不能拿到真实文件系统路径
出于安全限制,现代浏览器(Chrome、Edge、Safari)禁止 JavaScript 访问本地绝对路径。所有所谓“路径”都是沙箱内生成的逻辑标识:file.webkitRelativePath 就是这个机制下的产物——它不反映磁盘结构,只反映用户选中文件夹后,该文件在其内部的层级位置。
- Firefox 完全不支持
webkitRelativePath,即使加了webkitdirectory也返回空字符串 - 该字段值形如
"project/src/index.js",不含盘符、根斜杠或主机信息 - 如果用户没选整个文件夹(比如只勾选了子文件),
webkitRelativePath可能为空或不可靠
如何正确触发并读取 webkitRelativePath
必须同时满足三个条件:HTML input 标签带 webkitdirectory + directory + 用户主动选择文件夹(而非单个文件)。
- HTML 写法必须是:
(缺一不可) - 监听
change事件后,遍历e.target.files,对每个File对象取.webkitRelativePath - 第一个非空
webkitRelativePath的首段(split("/")[0])通常就是用户选中的文件夹名,但不能假设所有文件都以它开头——嵌套子文件夹会导致路径前缀不同
示例片段:
mozFullPath
-
mozFullPath自 Firefox 50 起已废弃,返回undefined -
FileReader只能读内容,无法还原路径;同步读取(readAsText配合result)也不提供路径元数据 - 即使 Chrome 中
webkitRelativePath存在,它的值也不稳定:若用户 Shift+Click 多选跨目录文件,部分项可能无此字段 - 服务端收到的文件流里没有路径信息,
$_FILES(PHP)或req.files(Node.js)只含上传时的原始文件名,需前端额外传结构
真正可靠的路径组织逻辑必须由前端构造并随文件一起提交——比如把 webkitRelativePath 当作元数据附在 FormData 里,后端按此重建目录树。别指望浏览器给你一个可拼接的“文件夹路径”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











