MDN wants to talk to developers like you: https://qsurvey.mozilla.com/s3/8d22564490d8

IDBObjectStore.openCursor

这篇翻译不完整。请帮忙从英语翻译这篇文章

The openCursor() method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns a new IDBCursorWithValue object. Used for iterating through an object store with a cursor.

To determine if the add operation has completed successfully, listen for the results’s success event.

语法

var request = ObjectStore.openCursor(optionalKeyRange, optionalDirection);

返回

An IDBRequest object on which subsequent events related to this operation are fired.

异常

This method may raise a DOMException with a DOMError of one of the following types:

Exception Description
InvalidStateError This IDBObjectStore or IDBIndex has been deleted.
TransactionInactiveError This IDBObjectStore's transaction is inactive.
DataError The specified key or key range is invalid.
 

例子

In this simple fragment we create a transaction, retrieve an object store, then use a cursor to iterate through all the records in the object store:

var transaction = db.transaction("name", "readonly");
var objectStore = transaction.objectStore("name");
var request = objectStore.openCursor();
request.onsuccess = function(event) {
  var cursor = event.target.result;
  if(cursor) {
    // cursor.value contains the current record being iterated through
    // this is where you'd do something with the result
    cursor.continue();
  } else {
    // no more results
  }
};

参数

range
The key range to be queried. If a single valid key is passed, this will default to a range containing only that key. If nothing is passed, this will default to a key range that selects all the records in this object store.
direction
An IDBCursorDirection telling the cursor what direction to travel. Defaults to "next".

Specification

Specification Status Comment
Indexed Database API
openCursor
Candidate Recommendation  

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 23webkit
24
10 moz
16.0 (16.0)
10, partial 15 7.1
Feature Android Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile
Basic support 4.4 22.0 (22.0) 1.0.1 10 22 未实现

另请参阅

文档标签和贡献者

 此页面的贡献者: teoli, looch
 最后编辑者: looch,