IDBCursorWithValue
注意：此功能在 Web Workers 中可用。
IDBCursorWithValue 接口是 IndexedDB API 的一部分，用于表示用于遍历或迭代数据库中多个记录的 游标。它与 IDBCursor 相同，只是增加了一个 value 属性。
游标有一个源，指示它正在迭代哪个索引或对象存储。它在范围内的位置，并以记录键递增或递减的方向移动。游标允许应用程序异步处理游标范围内的所有记录。
您可以同时拥有无限数量的游标。对于给定的游标，您始终获得相同的 IDBCursorWithValue 对象。操作是在底层索引或对象存储上执行的。
实例方法
继承自其父接口 IDBCursor 的方法。
实例属性
继承自其父接口 IDBCursor 的属性。
IDBCursorWithValue.value只读-
返回当前游标的值。
示例
在此示例中，我们创建一个事务，检索一个对象存储，然后使用游标遍历对象存储中的所有记录。游标不需要我们根据键来选择数据；我们可以获取所有数据。另请注意，在循环的每次迭代中，您都可以使用 cursor.value.foo 从游标对象下的当前记录中获取数据。有关完整的可运行示例，请参阅我们的 IDBCursor 示例（实时查看示例）。
js
function displayData() {
const transaction = db.transaction(["rushAlbumList"], "readonly");
const objectStore = transaction.objectStore("rushAlbumList");
objectStore.openCursor().onsuccess = (event) => {
const cursor = event.target.result;
if (cursor) {
const listItem = document.createElement("li");
listItem.textContent = `${cursor.value.albumTitle}, ${cursor.value.year}`;
list.appendChild(listItem);
cursor.continue();
} else {
console.log("Entries all displayed.");
}
};
}
规范
| 规范 |
|---|
| Indexed Database API 3.0 # idbcursorwithvalue |
浏览器兼容性
加载中…
另见
- 使用 IndexedDB
- 开始事务：
IDBDatabase - 使用事务：
IDBTransaction - 设置键的范围：
IDBKeyRange - 检索和修改数据：
IDBObjectStore - 使用游标：
IDBCursor - 参考示例：待办事项通知（查看实时示例）。