Firefox Tomorrow

web api instance property

File: webkitRelativePath property

View on MDN ↗

Available in workers

The webkitRelativePath read-only property of the File interface contains a string which specifies the file’s path relative to the directory selected by the user in an <input> element with its webkitdirectory attribute set.

Value

A string 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

<input type="file" id="file-picker" name="fileList" webkitdirectory multiple />
<output id="output"></output>
output {
  display: block;
  white-space: pre-wrap;
}

JavaScript

const output = document.getElementById("output");
const filePicker = document.getElementById("file-picker");

filePicker.addEventListener("change", (event) => {
  const files = event.target.files;

  for (const file of files) {
    output.textContent += `${file.webkitRelativePath}\n`;
  }
});

Result

Interactive exampleOpen the canonical MDN source to run this embedded demo.

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also