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.
DOMCursor.done
A boolean indicating if the cursor has reached the last result.
DOMCursor.continue()
Moves the cursor to the next result.
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();
}
}
Not currently part of any specification.
Support removed in Firefox 61.