DeviceStorage.enumerateEditable()

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 since which 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();

}

}