OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // Use the <code>chrome.fileSystem</code> API to create, read, navigate, | 5 // Use the <code>chrome.fileSystem</code> API to create, read, navigate, |
6 // and write to the user's local file system. With this API, Chrome Apps can | 6 // and write to the user's local file system. With this API, Chrome Apps can |
7 // read and write to a user-selected location. For example, a text editor app | 7 // read and write to a user-selected location. For example, a text editor app |
8 // can use the API to read and write local documents. All failures are notified | 8 // can use the API to read and write local documents. All failures are notified |
9 // via chrome.runtime.lastError. | 9 // via chrome.runtime.lastError. |
10 namespace fileSystem { | 10 namespace fileSystem { |
(...skipping 66 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
77 boolean? acceptsAllTypes; | 77 boolean? acceptsAllTypes; |
78 | 78 |
79 // Whether to accept multiple files. This is only supported for openFile and | 79 // Whether to accept multiple files. This is only supported for openFile and |
80 // openWritableFile. The callback to chooseEntry will be called with a list | 80 // openWritableFile. The callback to chooseEntry will be called with a list |
81 // of entries if this is set to true. Otherwise it will be called with a | 81 // of entries if this is set to true. Otherwise it will be called with a |
82 // single Entry. | 82 // single Entry. |
83 boolean? acceptsMultiple; | 83 boolean? acceptsMultiple; |
84 }; | 84 }; |
85 | 85 |
86 // Change to an entry within a tracked directory. | 86 // Change to an entry within a tracked directory. |
87 dictionary ChildChange { | 87 [nodoc] dictionary ChildChange { |
88 [instanceOf=Entry] object entry; | 88 [instanceOf=Entry] object entry; |
89 ChildChangeType type; | 89 ChildChangeType type; |
90 }; | 90 }; |
91 | 91 |
92 // Event notifying about a change in a file or a directory, including its | 92 // Event notifying about a change in a file or a directory, including its |
93 // contents. | 93 // contents. |
94 dictionary EntryChangedEvent { | 94 [nodoc] dictionary EntryChangedEvent { |
95 // Tracked entry. | 95 // Tracked entry. |
96 [instanceOf=Entry] object target; | 96 [instanceOf=Entry] object target; |
97 | 97 |
98 // List of changed entries within the tracked directory in order they | 98 // List of changed entries within the tracked directory in order they |
99 // happened. May not be available for some types of file systems. | 99 // happened. May not be available for some types of file systems. |
100 ChildChange[]? childChanges; | 100 ChildChange[]? childChanges; |
101 }; | 101 }; |
102 | 102 |
103 // Event notifying about a tracked file or a directory being removed. | 103 // Event notifying about a tracked file or a directory being removed. |
104 dictionary EntryRemovedEvent { | 104 [nodoc] dictionary EntryRemovedEvent { |
105 [instanceOf=Entry] object target; | 105 [instanceOf=Entry] object target; |
106 }; | 106 }; |
107 | 107 |
108 callback GetDisplayPathCallback = void (DOMString displayPath); | 108 callback GetDisplayPathCallback = void (DOMString displayPath); |
109 callback EntryCallback = void ([instanceOf=Entry] object entry); | 109 callback EntryCallback = void ([instanceOf=Entry] object entry); |
110 callback EntriesCallback = void ( | 110 callback EntriesCallback = void ( |
111 [instanceOf=Entry] optional object entry, | 111 [instanceOf=Entry] optional object entry, |
112 [instanceOf=FileEntry] optional object[] fileEntries); | 112 [instanceOf=FileEntry] optional object[] fileEntries); |
113 callback IsWritableCallback = void (boolean isWritable); | 113 callback IsWritableCallback = void (boolean isWritable); |
114 callback IsRestorableCallback = void (boolean isRestorable); | 114 callback IsRestorableCallback = void (boolean isRestorable); |
115 callback GetObservedEntriesCallback = void ( | 115 [nodoc] callback GetObservedEntriesCallback = void ( |
116 [instanceOf=Entry] object[] entries); | 116 [instanceOf=Entry] object[] entries); |
117 | 117 |
118 interface Functions { | 118 interface Functions { |
119 // Get the display path of an Entry object. The display path is based on | 119 // Get the display path of an Entry object. The display path is based on |
120 // the full path of the file or directory on the local file system, but may | 120 // the full path of the file or directory on the local file system, but may |
121 // be made more readable for display purposes. | 121 // be made more readable for display purposes. |
122 static void getDisplayPath([instanceOf=Entry] object entry, | 122 static void getDisplayPath([instanceOf=Entry] object entry, |
123 GetDisplayPathCallback callback); | 123 GetDisplayPathCallback callback); |
124 | 124 |
125 // Get a writable Entry from another Entry. This call will fail with a | 125 // Get a writable Entry from another Entry. This call will fail with a |
(...skipping 53 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
179 }; | 179 }; |
180 | 180 |
181 interface Events { | 181 interface Events { |
182 // Called when an observed entry is changed. | 182 // Called when an observed entry is changed. |
183 [nodoc] static void onEntryChanged(EntryChangedEvent event); | 183 [nodoc] static void onEntryChanged(EntryChangedEvent event); |
184 | 184 |
185 // Called when an observed entry is removed. | 185 // Called when an observed entry is removed. |
186 [nodoc] static void onEntryRemoved(EntryRemovedEvent event); | 186 [nodoc] static void onEntryRemoved(EntryRemovedEvent event); |
187 }; | 187 }; |
188 }; | 188 }; |
OLD | NEW |