FileSystemEntry.fullPath

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

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

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

 Last updated by: chrisdavidmills,