File.webkitRelativePath
Baseline
2025
Newly available
Since August 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
非标准: 该特性尚未标准化。我们不建议在生产环境中使用非标准特性，因为它们在浏览器中的支持有限，且可能发生变化或被移除。不过，在没有标准选项的特定情况下，它们可以作为合适的替代方案。
File.webkitRelativePath 是只读属性，包含 USVString，它规定了文件的路径，相对于用户在 <input> 元素中选择的目录，这个元素设置了 webkitdirectory 属性。
语法
relativePath = File.webkitRelativePath
值
USVString 包含文件路径，相对于用户所选的祖先目录。
示例
这个示例展示了目录选择器，它让用户选择一个或多个目录。change 事件触发时，所选目录包含的所有文件的列表，会生成并展示，带有所选目录的层次结构。
HTML
html
<input type="file" id="filepicker" name="fileList" webkitdirectory multiple />
<ul id="listing"></ul>
JavaScript
js
document.getElementById("filepicker").addEventListener(
"change",
function (event) {
let output = document.getElementById("listing");
let files = event.target.files;
for (let i = 0; i < files.length; i++) {
let item = document.createElement("li");
item.innerHTML = files[i].webkitRelativePath;
output.appendChild(item);
}
},
false,
);
结果
特别提醒：假设文件路径是 C:\f1\f2\f3\file.txt, 用户选择的是 f1 文件夹，则 Chrome、Firefox、Edge 都能正确返回 f2/f3/file.txt 值。而国产的 QQ 浏览器、360 浏览器、UC 浏览器、搜狗浏览器都只能返回 f3/file.txt。也就是国产浏览器调用 webkitRelativePath 返回的结果都不会是你希望得到的路径，请注意使用时的细微差距。
规范
| Specification |
|---|
| File and Directory Entries API # dom-file-webkitrelativepath |
这个 API 没有官方的 W3C 或者 WHATWG 规范。