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

作者：袖梨 2026-08-04

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

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

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

创建并启动游标遍历

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

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

递归或循环驱动游标前进

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

递归方式：在 onsuccess 中判断 cursor 是否存在，存在则处理当前项，并立即调用 cursor.continue()
循环模拟（不推荐直接 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');