如何用 IDBCursor 游标机制遍历本地数据库的所有数据集

处理如何用 IDBCursor 游标机制遍历本地数据库的所有数据集这类问题时，先确认目标场景，再按步骤核对配置或玩法细节。

IDBCursor 是 IndexedDB 中逐条遍历对象存储数据的核心机制，需通过 openCursor() 启动，手动调用 continue() 推进，支持正向、反向及键范围筛选，避免内存溢出。

IDBCursor 是 IndexedDB 中用于逐条读取对象存储（Object Store）数据的核心机制，它支持正向、反向遍历，也支持按键范围筛选。要遍历一个对象存储中的所有数据，关键不是“一次性获取全部”，而是用游标逐步迭代——这是 IndexedDB 的设计哲学：避免内存溢出，适配海量数据。

创建并启动游标遍历

需先打开数据库、获取事务和对象存储，再调用 openCursor() 启动游标。游标默认从首条记录开始正向遍历：

1. 确保事务权限为 "readonly" 或 "readwrite"（只读遍历推荐前者）
2. objectStore.openCursor() 返回 Promise 包裹的 IDBRequest，其 onsuccess 回调中可获取游标实例
3. 若游标存在（event.target.result 非 undefined），可通过 cursor.value 取当前记录，cursor.key 取主键，cursor.primaryKey（同 key，除非用了 keyPath + out-of-line key）

递归或循环驱动游标前进

游标不会自动推进，必须显式调用 cursor.continue() 才能移动到下一条。常用两种方式驱动：

1. 递归方式：在 onsuccess 中判断 cursor 是否存在，存在则处理当前项，并立即调用 cursor.continue()
2. 循环模拟（不推荐直接 while）：因 IndexedDB 是异步 API，不能用同步 while 循环等待；应使用递归或 async/await 封装（见下文）

用 async/await 封装游标遍历（更直观）

借助 Promise 化游标请求，可写出类似同步的遍历逻辑：

async function getAllData(db, storeName) {  const tx = db.transaction(storeName, 'readonly');  const store = tx.objectStore(storeName);  const data = [];  return new Promise((resolve, reject) => {    const req = store.openCursor();    req.onsuccess = () => {      const cursor = req.result;      if (cursor) {        data.push(cursor.value);        cursor.continue(); // 继续下一项      } else {        resolve(data); // 游标走完，结束      }    };    req.onerror = () => reject(req.error);  });}

调用时：const items = await getAllData(db, 'users');

按方向或范围限制遍历

openCursor() 支持传入参数控制行为：

1. store.openCursor(null, 'prev')：反向遍历（从末尾开始）
2. store.openCursor(IDBKeyRange.bound('A', 'M'))：只遍历主键在 A–M 范围内的记录
3. store.openCursor(IDBKeyRange.lowerBound(100))：主键 ≥ 100 的记录

注意：范围匹配依赖主键类型（number/string）和索引是否支持；若用自增 number 主键，范围查询效率高且稳定。

游标机制本身不复杂，但容易卡在“忘记 continue”或“误用同步逻辑”。只要记住：每次拿到游标后，处理完当前项，必须主动 continue() 或退出，否则遍历就停在那里了。