This is an archived page. It's not actively maintained.


This API is available on Firefox OS for privileged or certified applications only.


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.


var instanceOfDOMCursor = instanceOfDeviceStorage.enumerateEditable([path][, options]);


path Optional
A string representing a path directory within the storage area where to search for files.
options Optional
An object with the property since which is a Date object. Files older than that date will be ignored during the iteration process.


It returns a DOMCursor object to handle the success or error of the iteration.


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.


Not part of any specification.

See also