Web expose FileSystemFileEntry, FileSystemDirectoryEntry and friends

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 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 83 matching lines @@
 
   // Represents a mounted volume, which can be accessed via <code>chrome.
   // fileSystem.requestFileSystem</code>.
   dictionary Volume {
     DOMString volumeId;
     boolean writable;
   };
 
   // Change to an entry within a tracked directory.
   [nodoc] dictionary ChildChange {
-    [instanceOf=Entry] object entry;
+    [instanceOf=FileSystemEntry] object entry;
     ChildChangeType type;
   };
 
   // Event notifying about an inserted or a removed volume from the system.
   dictionary VolumeListChangedEvent {
     Volume[] volumes;
   };
 
   // Event notifying about a change in a file or a directory, including its
   // contents.
   [nodoc] dictionary EntryChangedEvent {
     // Tracked entry.
-    [instanceOf=Entry] object target;
+    [instanceOf=FileSystemEntry] object target;
 
     // List of changed entries within the tracked directory in order they
     // happened. May not be available for some types of file systems.
     ChildChange[]? childChanges;
   };
 
   // Event notifying about a tracked file or a directory being removed.
   [nodoc] dictionary EntryRemovedEvent {
-    [instanceOf=Entry] object target;
+    [instanceOf=FileSystemEntry] object target;
   };
 
   callback GetDisplayPathCallback = void (DOMString displayPath);
-  callback EntryCallback = void ([instanceOf=Entry] object entry);
+  callback EntryCallback = void ([instanceOf=FileSystemEntry] object entry);
   callback EntriesCallback = void (
-      [instanceOf=Entry] optional object entry,
-      [instanceOf=FileEntry] optional object[] fileEntries);
+      [instanceOf=FileSystemEntry] optional object entry,
+      [instanceOf=FileSystemFileEntry] optional object[] fileEntries);
   callback IsWritableCallback = void (boolean isWritable);
   callback IsRestorableCallback = void (boolean isRestorable);
   [nodoc] callback GetObservedEntriesCallback = void (
-      [instanceOf=Entry] object[] entries);
+      [instanceOf=FileSystemEntry] object[] entries);
   callback RequestFileSystemCallback = void(
       [instanceOf=FileSystem] optional object fileSystem);
   callback GetVolumeListCallback = void(optional Volume[] volumes);
 
   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,
+    static void getDisplayPath([instanceOf=FileSystemEntry] object entry,
                                GetDisplayPathCallback 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,
+    static void getWritableEntry([instanceOf=FileSystemEntry] object entry,
                                  EntryCallback callback);
 
     // Gets whether this Entry is writable or not.
-    static void isWritableEntry([instanceOf=Entry] object entry,
+    static void isWritableEntry([instanceOf=FileSystemEntry] object entry,
                                 IsWritableCallback callback);
 
     // Ask the user to choose a file or directory.
     static void chooseEntry(optional ChooseEntryOptions options,
                             EntriesCallback callback);
 
     // Returns the file entry with the given id if it can be restored. This call
     // will fail with a runtime error otherwise.
     static void restoreEntry(DOMString id, EntryCallback callback);
 
     // Returns whether the app has permission to restore the entry with the
     // given id.
     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.
-    static DOMString retainEntry([instanceOf=Entry] object entry);
+    static DOMString retainEntry([instanceOf=FileSystemEntry] object entry);
 
     // Requests access to a file system for a volume represented by <code>
     // options.volumeId</code>. If <code>options.writable</code> is set to true,
     // then the file system will be writable. Otherwise, it will be read-only.
     // The <code>writable</code> option requires the <code>
     // "fileSystem": {"write"}</code> permission in the manifest. Available to
     // kiosk apps running in kiosk session only. For manual-launch kiosk mode, a
     // confirmation dialog will be shown on top of the active app window.
     // In case of an error, <code>fileSystem</code> will be undefined, and
     // <code>chrome.runtime.lastError</code> will be set.
@@ skipping 14 matching lines @@
     // is closed or suspended, unless <code>entry</code> is retained using
     // <code>chrome.fileSystem.retainEntry</code>.
     //
     // In such case of retained entries, the observer stays active across
     // restarts until <code>unobserveEntry</code> is explicitly called. Note,
     // that once the <code>entry</code> is not retained anymore, the observer
     // will be removed automatically. Observed entries are also automatically
     // restored when either <code>getObservers</code> is called, or an observing
     // event for it is invoked.
     [nodoc] static void observeDirectory(
-        [instanceOf=DirectoryEntry] object entry,
+        [instanceOf=FileSystemDirectoryEntry] object entry,
         optional boolean recursive);
 
     // Unobserves a previously observed either a file or a directory.
-    [nodoc] static void unobserveEntry([instanceOf=Entry] object entry);
+    [nodoc] static void unobserveEntry([instanceOf=FileSystemEntry] object entry);
 
     // Lists all observed entries.
     [nodoc] static void getObservedEntries(GetObservedEntriesCallback callback);
   };
 
   interface Events {
     // Called when a list of available volumes is changed.
     static void onVolumeListChanged(VolumeListChangedEvent event);
 
     // Called when an observed entry is changed.
     [nodoc] static void onEntryChanged(EntryChangedEvent event);
 
     // Called when an observed entry is removed.
     [nodoc] static void onEntryRemoved(EntryRemovedEvent event);
   };
 };