DOMCursor

A DOMCursor object represents an ongoing operation over a list of results. It is an enhanced DOMRequest that allows to iterate through a list of results asynchronously. Each time its continue() method is called, the DOMCursor tries to reach the next result in the list and calls its result's success or error accordingly.

Note: This feature is available in Web Workers.

Properties

DOMCursor.done
A boolean indicating if the cursor has reached the last result.

Methods

DOMCursor.continue()
Moves the cursor to the next result.

Example

var sdcard = navigator.getDeviceStorage('sdcard');
var cursor = sdcard.enumerate();

cursor.onsuccess = function () {
  console.log("File found: " + this.result.name);

  // Once we found a file we check if there is other results
  if (!this.done) {
    // Then we move to the next result, which call the
    // cursor success with the next file as result.
    this.continue();
  }
}

Specification

Not currently part of any specification.

Browser compatibility

Supported in Firefox 21.
Available in workers in Firefox 41.
Support removed in Firefox 61.

See also