当前位置:首页 > 文章列表 > 文章 > 前端 > IndexedDB getAll 怎样限制查询数量并保留键范围

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

来源:17golang原创 2026-11-17 01:25:42 0浏览 收藏

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删除
WebSocket binaryType 怎样决定二进制消息的返回类型WebSocket binaryType 怎样决定二进制消息的返回类型
上一篇
WebSocket binaryType 怎样决定二进制消息的返回类型
Web Share API 怎样判断分享能力并安全降级
下一篇
Web Share API 怎样判断分享能力并安全降级
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1057次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1059次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1224次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1165次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1009次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码