IDBObjectStore: openCursor() 方法

语法

openCursor()
openCursor(query)
openCursor(query, direction)

参数

query 可选

要查询的键或 IDBKeyRange。如果传递单个有效键，则默认范围仅包含该键。如果未传递任何内容，则默认范围将选择此对象存储中的所有记录。

direction 可选

一个字符串，用于告知游标的移动方向。默认值为 next。有效值为：

next

游标在存储区的开头打开；然后，游标以递增的键顺序返回所有记录，包括重复项。

nextunique

游标在存储区的开头打开；然后，游标以递增的键顺序返回所有非重复记录。

prev

游标在存储区的末尾打开；然后，游标以递减的键顺序返回所有记录，包括重复项。

prevunique

游标在存储区的末尾打开；然后，游标以递减的键顺序返回所有非重复记录。

返回值

一个 IDBRequest 对象，后续与此操作相关的事件会在此对象上触发。

如果操作成功，请求的 result 属性的值是

• 一个指向第一个匹配给定查询的记录的 IDBCursorWithValue 对象
• 如果未找到匹配的记录，则为 null。

异常

此方法可能会抛出以下类型之一的DOMException：

InvalidStateError DOMException

如果此 IDBObjectStore 或 IDBIndex 已被删除，则抛出此异常。

TransactionInactiveError DOMException

如果此 IDBObjectStore 的事务不活跃，则会抛出此异常。

DataError DOMException

如果指定的键或键范围无效，则抛出此异常。

示例

在这个简单的代码片段中，我们创建了一个事务，检索了一个对象存储，然后使用游标遍历对象存储中的所有记录。

const transaction = db.transaction("name", "readonly");
const objectStore = transaction.objectStore("name");
const request = objectStore.openCursor();
request.onsuccess = (event) => {
  const 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
  }
};

规范

浏览器兼容性

另见

• 使用 IndexedDB
• 开始事务：IDBDatabase
• 使用事务：IDBTransaction
• 设置键的范围：IDBKeyRange
• 检索和修改数据：IDBObjectStore
• 使用游标：IDBCursor
• 参考示例：待办事项通知（查看实时示例）。