IDBCursor遍历本地数据库全数据方法

本文深入解析了 IndexedDB 中 IDBCursor 游标机制的核心用法，重点讲解如何安全、高效地遍历本地数据库的全量数据——不依赖一次性加载（避免内存溢出），而是通过 openCursor() 启动游标、手动调用 continue() 逐条推进，并支持正向/反向遍历及键范围筛选；同时提供递归与 async/await 两种实用封装方案，直击开发者常踩的“忘记 continue”和“误用同步循环”等坑点，助你真正掌握 IndexedDB 海量数据遍历的底层逻辑与最佳实践。

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');

按方向或范围限制遍历

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

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

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

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

本篇关于《IDBCursor遍历本地数据库全数据方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！