Web/API/File/webkitRelativePath

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 APIThe definition of 'webkitRelativePath' in that specification.	Draft	Initial specification.

This API has no official W3C or WHATWG specification.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`webkitRelativePath`	Chrome Full support 13 Prefixed' Full support 13 Prefixed' Prefixed' Implemented with the vendor prefix: webkit	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 Prefixed' Full support 18 Prefixed' Prefixed' Implemented with the vendor prefix: webkit	Firefox Android Full support 49	Opera Android No support No	Safari iOS Full support 11.3	Samsung Internet Android Full support 1.0 Prefixed' Full support 1.0 Prefixed' Prefixed' Implemented with the vendor prefix: webkit

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.