DOMCursor

概要

DOMCursor オブジェクトは結果のリスト全体の継続的な操作を可能にしています。これは、結果のリストを非同期で反復することを許可したDOMRequest を拡張したものです。continue()メソッドが呼ばれるたびに、DOMCurosr はリストの次の要素へ移動を試み、結果の成功または失敗を呼び出します。

属性

DOMCursor.done

最後の要素に達しているかを示します。

Inherited from DOMRequest:

DOMRequest.onsuccess

A callback handler called when the operation represented by the DOMRequest is completed.

DOMRequest.onerror

A callback handler that gets called when an error occurs while processing the operation.

DOMRequest.readyState

A string indicating whether or not the operation is finished running. Its value is either "done" or "pending".

DOMRequest.result

The operation's result.

DOMRequest.error

Error information, if any.

メソッド

DOMCursor.continue()

次のカーソルへと移動します。

例

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.

関連情報

• DOMRequest