Your Search Results


    This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.



    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.


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


    Moves the cursor to the next result.


    var sdcard = navigator.getDeviceStorage('sdcard');
    var cursor = sdcard.enumerate();
    cursor.onsuccess = function () {
      console.log("File found: " +;
      // 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.

    Browser compatibility

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support ? 21.0 (21.0) ? ? ?
    Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support ? ? 21.0 (21.0) ? ? ?


    Not currently part of any specification.

    See also

    Document Tags and Contributors

    Contributors to this page: Jeremie, teoli, kscarfone, MHasan,
    Last updated by: teoli,