登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  前端

IndexedDB getAll 怎样限制查询数量并保留键范围

来源:17golang原创

时间:2026-11-17 01:25:42 178浏览 收藏

IndexedDB 查询需要“只取某个键范围里的前几条记录”时,不必先打开游标再手动计数:可以把 IDBKeyRange 作为 getAll() 的查询条件,把数量上限作为第二个参数传入。最小写法是 store.getAll(range, limit),返回的仍然是按键顺序排列的数组。

把筛选条件交给 query,把返回上限交给 count;如果还要判断某个键是否真的存在,不要只根据 getAll() 返回的 undefined 猜测,改用 count() 或游标确认。

本文只讨论 IDBObjectStore.getAll() 的键范围、数量限制和结果边界。下面示例假设数据库对象已经打开,并且存在名为 books 的对象仓库。

getAll 的两个参数分别解决什么问题

getAll(query, count) 的第一个参数决定“查哪些键”,第二个参数决定“最多返回多少个值”。query 可以是单个键,也可以是 IDBKeyRange;省略它时,查询范围相当于整个对象仓库。count 是可选的非负整数,匹配记录少于这个数时只返回实际匹配项。

写法作用适合场景
getAll()读取全部可匹配记录数据量已知且很小
getAll(key)读取一个键对应的值按主键取单条记录
getAll(range, 20)范围内最多取 20 条列表首屏或小批量读取

这里的 count 不是总记录数,也不是从任意偏移量开始的页码。它只是本次请求允许放进结果数组的最大值;默认遍历方向是按键递增。

用 IDBKeyRange 保留筛选范围

如果对象仓库的键是数字,可以用闭区间 bound(100, 199) 保留 100 到 199 的记录,再交给 getAll() 限制返回量:

function readBookPage(db, lowerKey, upperKey, limit) {
  // 只读事务只负责本次查询,避免把查询写入事务混在一起。
  const transaction = db.transaction("books", "readonly");
  const store = transaction.objectStore("books");

  // 默认是闭区间,lowerKey 和 upperKey 都会被包含在范围内。
  const range = IDBKeyRange.bound(lowerKey, upperKey);

  // count 是返回上限,不是总数;结果仍按对象仓库的键顺序返回。
  return store.getAll(range, limit);
}

const request = readBookPage(db, 100, 199, 20);
request.onsuccess = () => {
  // result 始终是数组;没有匹配项时是空数组。
  const books = request.result;
  renderBooks(books);
};
request.onerror = () => {
  // 读取失败时保留原始错误,便于调用方决定是否重试。
  console.error("IndexedDB 读取失败", request.error);
};
IndexedDB 对象仓库、IDBKeyRange 查询范围与 getAll 数量上限之间的静态关系图
图1:静态结构说明图。对象仓库提供键和值,IDBKeyRange 表示筛选范围,getAll 的 count 只限制返回数组长度;这不是浏览器截图或运行证据。

IDBKeyRange.bound() 默认包含两个端点。如果上限不应被包含,可以把第四个参数设为 true,例如 IDBKeyRange.bound(100, 199, false, true) 表示大于等于 100 且小于 199。单值查询则使用 IDBKeyRange.only(key),不需要为了一个键构造上下界。

把 IDBRequest 封装成可复用的 Promise

实际项目通常不希望每个调用点都重复写两个事件处理器。可以把请求封装起来,同时在创建请求前校验数量上限:

function getValuesByRange(db, lowerKey, upperKey, limit = 20) {
  // IndexedDB 的 count 必须是 0 到 2^32 - 1 之间的整数。
  if (!Number.isInteger(limit) || limit  0xffffffff) {
    return Promise.reject(new RangeError("limit 必须是合法的无符号整数"));
  }

  return new Promise((resolve, reject) => {
    // 查询只读仓库;事务必须在这里创建,不能等待异步回调后再取 store。
    const transaction = db.transaction("books", "readonly");
    const store = transaction.objectStore("books");
    const range = IDBKeyRange.bound(lowerKey, upperKey);
    const request = store.getAll(range, limit);

    // 成功时返回数组,即使范围内没有记录也不会返回 null。
    request.onsuccess = () => resolve(request.result);
    request.onerror = () => reject(request.error);
    transaction.onabort = () => {
      // 事务被中止时补充一个可识别的错误,避免 Promise 一直等待。
      reject(transaction.error || new Error("IndexedDB 事务已中止"));
    };
  });
}

getValuesByRange(db, 100, 199, 20)
  .then((books) => {
    // 调用方只关心结果数组,不必感知 IDBRequest 的事件细节。
    renderBooks(books);
  })
  .catch((error) => {
    // 统一处理参数错误、请求错误和事务中止。
    console.error("查询 books 失败", error);
  });

封装的重点是“在当前调用栈里创建事务并立即发出请求”。不要把 objectStore() 留到另一个稍后的异步回调中;事务可能已经变成 inactive,届时会得到 TransactionInactiveError。

为什么空数组不能证明某个值不存在

getAll() 的结果是值数组。记录不存在时,查询结果为空数组;但如果确实存在一条记录,而该记录的值本身是 undefined,调用方看到的值也可能无法仅凭数组内容判断来源。要回答“这个键有没有记录”,应使用同一个键调用 count():

function hasBook(db, key) {
  return new Promise((resolve, reject) => {
    // count 统计匹配键的记录条数,比检查 getAll 的值更明确。
    const transaction = db.transaction("books", "readonly");
    const store = transaction.objectStore("books");
    const request = store.count(key);

    request.onsuccess = () => {
      // 主键唯一时,1 表示存在,0 表示不存在。
      resolve(request.result > 0);
    };
    request.onerror = () => reject(request.error);
  });
}
IndexedDB getAll 返回数组与 count 存在性判断的静态边界关系图
图2:静态边界说明图。getAll 的查询范围、结果数组和 count 的存在性判断承担不同职责,避免把空数组或 undefined 混成同一种状态。

如果还需要同时拿到键和值,可以改用游标读取;但那会进入另一种读取模型。当前问题只需要判断存在性时,count(key) 更直接,也不会把结果数组当成布尔值使用。

几个容易踩到的边界

  • 把 count 当成偏移量: getAll(range, 20) 没有“从第 21 条开始”的含义,只会返回范围内按键顺序的前 20 个值。需要稳定分页时,应保存最后一个键并构造下一个范围,或使用游标。
  • 传入负数或超大数量: count 必须落在无符号 32 位整数范围内,参数错误会抛出 TypeError。业务层最好在创建请求前做整数校验。
  • 把范围端点写错: bound() 的第三、第四个参数分别控制下限和上限是否开放。边界记录是否包含,必须和列表的业务语义一致。
  • 查询启动太晚: 事务、仓库和请求应在同一个同步调用段内建立。不要先等待网络请求,再尝试复用原来的 IDBObjectStore。
  • 把空结果当异常: 范围没有匹配记录时,成功回调仍会执行,结果是空数组;只有请求或事务失败才进入错误处理。

最后记住这三个判断

第一,筛选范围交给 IDBKeyRange,返回数量交给 count;第二,getAll() 成功时给数组,空范围不等于请求失败;第三,确认记录存在时用 count(key) 或游标,不要根据值是否为 undefined 做猜测。这样既能写出短的首屏读取,也能把查询边界留在 IndexedDB 原生 API 的语义里。

相关问题

  • getAll 的 count 能控制从第几条开始吗?不能,它只控制最多返回数量,不提供偏移量。
  • IDBKeyRange.bound 是否包含端点?默认包含;通过第三、第四个布尔参数可以分别打开下限或上限。
  • 没有记录时 getAll 会抛错吗?正常情况下不会,成功结果是空数组。
  • 什么时候应该改用游标?需要逐条处理、读取键、控制方向或实现稳定分页时,更适合使用游标。
声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>