Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The File.webkitRelativePath
is a read-only property that contains a USVString
which specifies the file's path relative to the directory selected by the user in an <input>
element with its webkitdirectory
attribute set.
Syntax
relativePath = File
.webkitRelativePath
Value
A USVString
containing the path of the file relative to the ancestor directory the user selected.
Example
In this example, a directory picker is presented which lets the user choose one or more directories. When the change
event occurs, a list of all files contained within the selected directory hierarchies is generated and displayed.
HTML content
<input type="file" id="filepicker" name="fileList" webkitdirectory multiple /> <ul id="listing"></ul>
JavaScript content
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);
Result
Specifications
Specification | Status | Comment |
---|---|---|
File and Directory Entries API The definition of 'webkitRelativePath' in that specification. |
Draft | Initial specification. |
This API has no official W3C or WHATWG specification.
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
webkitRelativePath | Chrome
Full support
13
| Edge Full support 13 | Firefox Full support 49 | IE No support No | Opera No support No | Safari Full support 11.1 | WebView Android Full support Yes | Chrome Android
Full support
18
| Firefox Android Full support 49 | Opera Android No support No | Safari iOS Full support 11.3 | Samsung Internet Android
Full support
1.0
|
Legend
- Full support
- Full support
- No support
- No support
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.