openkeycursor 是 indexeddb 中用于仅获取键和主键的游标方法，不加载 value，从而减少 i/o 和内存开销、提升遍历性能；适用于统计、去重、批量删除等场景，但不支持写操作且 value 恒为 undefined。
HTML5中没有 openKeyCursor 这个方法。你可能混淆了 IndexedDB 的 API 名称——正确的方法是 openKeyCursor（注意是小写 k，且属于 IDBObjectStore 或 IDBIndex 的实例方法），但它本身**并不“仅检索键名”**，而是返回一个只包含键（key）和主键（primaryKey）信息的游标，不加载值（value）数据，从而在遍历时减少内存开销、提升性能。
为什么 openKeyCursor 能提升遍历速度？
普通游标（openCursor）每次迭代都会读取完整的记录（包括 key + value），而 openKeyCursor 仅获取键相关字段（key 和 primaryKey），跳过序列化/反序列化整个 value 对象的过程。尤其当 value 是大型对象、Blob 或嵌套结构时，性能差异明显。
- 不传输 value 数据，减少 IndexedDB 引擎内部 I/O 和内存分配
- 适合只需统计、去重、批量删除或判断存在性的场景
- 对高吞吐量只读遍历（如构建索引映射、校验键集合）特别有效
如何正确使用 openKeyCursor
调用方式与 openCursor 类似，但返回的游标对象中 value 始终为 undefined，只能访问 key 和 primaryKey：
const transaction = db.transaction('books', 'readonly');
const store = transaction.objectStore('books');
// 使用 openKeyCursor 遍历所有键
const keyCursorRequest = store.openKeyCursor();
keyCursorRequest.onsuccess = function(event) {
const cursor = event.target.result;
if (cursor) {
console.log('键:', cursor.key); // ✅ 可用
console.log('主键:', cursor.primaryKey); // ✅ 可用（通常与 key 相同，除非用 index）
console.log('值:', cursor.value); // ❌ 总是 undefined
cursor.continue();
}
};
配合索引使用 keyCursor 提升定向查询效率
若你在非主键字段上建立了索引（如 author），可对索引调用 openKeyCursor，快速获取匹配该字段的所有主键，再按需 fetch 完整记录：
const index = store.index('author');
const authorCursorReq = index.openKeyCursor(IDBKeyRange.only('鲁迅'));
authorCursorReq.onsuccess = function(e) {
const cursor = e.target.result;
if (cursor) {
// cursor.key 是 author 值（'鲁迅'），cursor.primaryKey 是对应记录的主键（如 123）
console.log('找到主键:', cursor.primaryKey);
cursor.continue();
}
};
- 避免全表扫描，利用索引 B+ 树结构快速定位键范围
- 结合
keyCursor+get()实现“查键再取值”的两阶段优化 - 比直接
index.openCursor().onsuccess少加载 value，更轻量
注意事项与常见误区
不是所有场景都适用 keyCursor；它牺牲 value 可访问性换取速度，需按需选择：
-
openKeyCursor不能用于添加、修改或删除操作（无 value 不支持写） - 无法通过 keyCursor 直接获取复合键中的子字段值（仍需打开完整游标或设计合适索引）
- 在事务提交前多次调用 keyCursor 不会自动缓存结果，每次 continue 仍是独立查询
- Chrome/Firefox/Edge 均支持，但旧版 Safari（≤12.1）对 keyCursor 的
primaryKey支持不一致，建议降级兜底
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
