IDBCursor: key 属性
注意：此功能在 Web Workers 中可用。
IDBCursor 接口中只读的 key 属性返回游标位置记录的键。如果游标超出了范围，则设置为 undefined。游标的键可以是任何数据类型。
值
任何类型的值。
异常
InvalidStateErrorDOMException-
如果在游标正在前进或已完成时访问，则会抛出此错误。
示例
在这个简单的代码片段中，我们创建一个事务，检索一个对象存储，然后使用游标遍历对象存储中的所有记录。在每次迭代中，我们将游标的键记录到控制台。
光标不需要我们根据键来选择数据；我们可以直接获取所有数据。另请注意，在循环的每次迭代中，你可以使用 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);
console.log(cursor.key);
cursor.continue();
} else {
console.log("Entries all displayed.");
}
};
}
规范
| 规范 |
|---|
| Indexed Database API 3.0 # ref-for-dom-idbcursor-key① |
浏览器兼容性
加载中…
另见
- 使用 IndexedDB
- 开始事务：
IDBDatabase - 使用事务：
IDBTransaction - 设置键的范围：
IDBKeyRange - 检索和修改数据：
IDBObjectStore - 使用游标：
IDBCursor - 参考示例：待办事项通知（查看实时示例）。