FileSystemEntry.fullPath

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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 read-only fullPath property of the FileSystemEntry interface returns a USVString specifying the full, absolute path from the file system's root to the file represented by the entry.

This can also be thought of as a path which is relative to the root directory, with a "/" prepended to it to make it absolute.

Syntax

var fullPath = FileSystemEntry.fullPath;

Value

A USVString indicating the entry's full path.

Example

This example shows a function which is called with a file system; it then gets a FileSystemFileEntry for a file named data.json and returns its full path.

function gotFileSystem(fs) {
  let path = "";

  fs.root.getFile("data.json", { create: true, exclusive: true }, function(entry) {
    path = fullPath;
  }, handleError(error));

  return path;
}

Obviously, this is somewhat contrived, since we know that the file's full path is "/data.json", having just looked it up ourselves, but the concept holds up for scenarios in which you don't know it.

Specifications

Specification Status Comment
File and Directory Entries API
The definition of 'fullPath' in that specification.
Editor's Draft Initial specification.

This API has no official W3C or WHATWG specification.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 13 webkit 50 (50) No support No support No support
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support No support 0.16 webkit 50.0 (50) No support No support No support

See also

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, Sheppy
 Last updated by: chrisdavidmills,