IDL for chrome.fileSystem.getFullPath.

chrome/common/extensions/api/file_system.idl

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Use the <code>chrome.fileSystem</code> API to create, read, navigate,
 // and write to a sandboxed section of the user's local file system. With this
 // API, Chrome Apps can read and write to a user-selected location. For
 // example, a text editor app can use the API to read and write local documents.
 // All failures are notified via chrome.runtime.lastError.
 namespace fileSystem {
@@ skipping 57 matching lines @@
     // in the accepts argument. The default is true. If the accepts field is
     // unset or contains no valid entries, this will always be reset to true.
     boolean? acceptsAllTypes;
 
     // Whether to accept multiple files. This is only supported for openFile and
     // openWritableFile. The callback to chooseEntry will be called with a list
     // of entries if this is set to true. Otherwise it will be called with a
     // single Entry.
     boolean? acceptsMultiple;
   };
-  callback GetDisplayPathCallback = void (DOMString displayPath);
+
+  dictionary GetFullPathOptions {
+    // Whether to resolve symlinks. The default is false.
+    boolean? resolveSymlinks;
+
+  };
+  callback GetPathCallback = void (DOMString path);
   callback EntryCallback = void ([instanceOf=Entry] object entry);
   callback EntriesCallback = void (
       [instanceOf=Entry] optional object entry,
       [instanceOf=FileEntry] optional object[] fileEntries);
   callback IsWritableCallback = void (boolean isWritable);
   callback IsRestorableCallback = void (boolean isRestorable);
 
   interface Functions {
     // Get the display path of an Entry object. The display path is based on
     // the full path of the file or directory on the local file system, but may
     // be made more readable for display purposes.
     static void getDisplayPath([instanceOf=Entry] object entry,
-                               GetDisplayPathCallback callback);
+                               GetPathCallback callback);
 
     // Get a writable Entry from another Entry. This call will fail with a
     // runtime error if the application does not have the 'write' permission
     // under 'fileSystem'. If entry is a DirectoryEntry, this call will fail if
     // the application does not have the 'directory' permission under
     // 'fileSystem'.
     static void getWritableEntry([instanceOf=Entry] object entry,
                                  EntryCallback callback);
 
     // Gets whether this Entry is writable or not.
@@ skipping 13 matching lines @@
     // given id. This method is new in Chrome 31.
     static void isRestorable(DOMString id, IsRestorableCallback callback);
 
     // Returns an id that can be passed to restoreEntry to regain access to a
     // given file entry. Only the 500 most recently used entries are retained,
     // where calls to retainEntry and restoreEntry count as use. If the app has
     // the 'retainEntries' permission under 'fileSystem', entries are retained
     // indefinitely. Otherwise, entries are retained only while the app is
     // running and across restarts. This method is new in Chrome 31.
     static DOMString retainEntry([instanceOf=Entry] object entry);
+
+    // Returns the full path on the local file system of an Entry object.
+    static void getFullPath([instanceOf=Entry] object entry,
+                            optional GetFullPathOptions options,
+                            GetPathCallback callback);
+
   };
 };