indexeddb分页查询用opencursor配合advance实现按需跳过前n条再取m条，比getall切片更省内存；advance(n)从当前位跳过n条停在第n+1条，须在onsuccess后调用且不能链式，跳过后需continue采集数据。
IndexedDB 中用 openCursor 配合 advance 实现分页查询，核心是**不一次性读取全部数据，而是按需跳过前 N 条、再取 M 条**。它比用 getAll + 数组切片更省内存，尤其适合大数据量场景。
理解 openCursor 和 advance 的协作逻辑
openCursor 启动游标遍历，advance(n) 是游标方法，作用是「跳过接下来的 n 条记录」，然后停在第 n+1 条上，触发 onsuccess。它不是跳到第 n 条，而是从当前位置（含）开始跳过 n 条 —— 所以首次调用前，游标默认停在第一条；调用 advance(10) 就会跳过前 10 条，停在第 11 条。
关键点：
- 必须在游标成功打开（
onsuccess触发）后，才能调用advance() -
advance()返回undefined，不能链式调用；它会异步移动游标，再次触发onsuccess - 跳过之后，需要手动调用
cursor.continue()或直接读取当前项，否则游标就停住了
实现分页查询的典型步骤
假设每页 20 条，查第 3 页（即跳过前 40 条，取第 41–60 条）：
- 用
objectStore.openCursor()打开游标 - 在第一次
onsuccess中，判断是否已跳到位：若cursor存在，且当前页码 > 1，就调用cursor.advance((page - 1) * pageSize) - 在后续的
onsuccess中（即跳转到位后），开始收集数据，每取一条就cursor.continue()，直到取满pageSize条或游标结束 - 用一个计数器控制采集条数，避免越界
完整可运行示例代码
以下是一个封装好的分页读取函数：
function getPage(db, storeName, page = 1, pageSize = 20) {
return new Promise((resolve, reject) => {
const tx = db.transaction(storeName, 'readonly');
const store = tx.objectStore(storeName);
const req = store.openCursor();
const results = [];
let count = 0;
let skipped = false;
<pre class="brush:php;toolbar:false;">req.onsuccess = () => {
const cursor = req.result;
if (!cursor) {
resolve(results);
return;
}
// 第一次进入：决定是否跳过
if (!skipped && page > 1) {
const skipCount = (page - 1) * pageSize;
cursor.advance(skipCount);
skipped = true;
return;
}
// 跳完后，开始采集
results.push(cursor.value);
count++;
if (count >= pageSize) {
resolve(results);
} else {
cursor.continue();
}
};
req.onerror = () => reject(req.error);}); }
// 使用示例 indexedDB.open('myDB', 1).onsuccess = (e) => { const db = e.target.result; getPage(db, 'users', 3, 20).then(data => { console.log('第 3 页数据:', data); // 41–60 条 }); };
注意事项和常见坑
实际使用中容易忽略这些细节：
-
advance(0)是非法操作，会报错；跳第 1 页时不要调用advance - 如果跳过的数量超过总记录数，游标会直接变为
null，onsuccess仍会触发，但req.result为undefined，需做空值判断 - 游标生命周期绑定事务，事务提前结束（如函数返回未 await）会导致游标失效；确保 Promise 完整 resolve/reject
- 如需按字段排序分页（如时间倒序），需先创建对应索引，并在
openCursor(index)中指定索引名
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
