objectStore.count() 可高效获取 IndexedDB 对象仓库记录总数或指定 keyRange 范围内的数量,需在打开数据库后的有效只读/读写事务中调用,结果在 onsuccess 中通过 this.result 获取,返回 number 类型。

使用 objectStore.count() 可以快速获取 IndexedDB 中某个对象仓库(object store)的记录总数,无需遍历所有数据,性能高效。
确认数据库和对象仓库已打开
调用 count() 前,必须确保已成功打开数据库,并在事务中正确获取了目标 object store。它不能在数据库未就绪或事务已结束时调用。
- 需在
onsuccess或onupgradeneeded回调中完成初始化 - 必须通过只读或读写事务访问 object store(
count()支持两种模式) - 示例常见错误:在
db.close()后调用,会报 “Transaction is inactive”
基本用法:获取全部记录数
不传参数时,count() 返回该 object store 中所有记录的数量:
const transaction = db.transaction(['users'], 'readonly');
const objectStore = transaction.objectStore('users');
const request = objectStore.count();
request.onsuccess = function() {
console.log('总记录数:', this.result); // 如:127
};
request.onerror = function() {
console.error('统计失败:', this.error);
};
带 keyRange 的条件计数
如果只需统计满足某范围条件的记录(如 ID 大于 100),可传入 IDBKeyRange:
-
IDBKeyRange.lowerBound(100):统计 key ≥ 100 的记录 -
IDBKeyRange.bound('2023-01-01', '2023-12-31'):统计日期范围内的记录(适用于 date 字符串索引) - 注意:keyRange 仅对主键(keyPath)或已创建索引的字段有效
示例:
const range = IDBKeyRange.lowerBound(100); const request = objectStore.count(range); // 只统计主键 ≥ 100 的条目
注意事项与常见问题
count() 是异步操作,结果在 onsuccess 中通过 event.target.result 或 this.result 获取。
- 返回值是 JavaScript number 类型,不是 Promise(如需 Promise 封装,可用
new Promise包一层) - 若 object store 为空,返回 0,不会报错
- 不支持复合主键的精细范围匹配(如部分字段限定),需依赖索引 + index.count()
- 浏览器兼容性良好(Chrome 24+、Firefox 23+、Edge 12+、Safari 10.1+)










