This API is available on Firefox OS for privileged or certified applications only.
Summary
The enumerateEditable method is used to iterate through the files of a given storage area.
If the request is successful, the request's result is a FileHandle object allowing to access and modify the current file reached on the device.
Syntax
var instanceOfDOMCursor = instanceOfDeviceStorage.enumerateEditable([path][, options]);
Parameters
pathOptional- A string representing a path directory within the storage area where to search for files.
optionsOptional- An object with the property
sincewhich is a Date object. Files older than that date will be ignored during the iteration process.
Returns
It returns a DOMCursor object to handle the success or error of the iteration.
Example
var sdcard = navigator.getDeviceStorage('sdcard');
// Let's retrieve files from last week.
var param = {
since = new Date((+new Date()) - 7*24*60*60*1000)
}
var cursor = sdcard.enumerateEditable(param);
cursor.onsuccess = function () {
var file = this.result;
console.log("File updated on: " + file.lastModifiedDate);
// Once we found a file we check if there are other results
if (!this.done) {
// Then we move to the next result, which calls the cursor
// success with the next file as result.
this.continue();
}
}
Specification
Not part of any specification.