HTML5中利用IDBIndex获取特定范围内的记录总数

IndexedDB中IDBIndex.count()配合IDBKeyRange是获取范围记录数的标准高效方式；需确保索引存在且支持范围查询，注意多值索引会按条目计数而非对象数。

在HTML5的IndexedDB中，若需快速统计特定范围内的记录总数，IDBIndex本身并未提供直接的“统计总数”API。然而，标准且高效的解决方案早已存在——即使用count()方法搭配IDBKeyRange。此方法不仅是官方推荐的做法，也具备最佳性能和最简洁的代码实现。

使用 index.count() 配合 keyRange

这是标准的操作流程：首先利用索引创建一个键范围，然后直接调用count()方法，即可获得匹配的记录数量。整个过程无需打开游标遍历，也无需读取实际数据，效率极高。

• 首先，确保目标索引已存在，并且建立在支持范围查询的字段上（例如字符串、数字、日期等类型）。
• 接着，使用IDBKeyRange.bound()、.lowerBound()或.upperBound()来精确划定所需范围。
• 最后，count()会返回一个IDBRequest对象，其result属性即为匹配的记录数。

以下是一个具体示例，展示如何统计名字在“Alice”到“Bob”之间的用户数量：

const transaction = db.transaction(['users'], 'readonly');
const store = transaction.objectStore('users');
const index = store.index('name'); // 假设已创建 name 索引
const range = IDBKeyRange.bound('Alice', 'Bob');
const request = index.count(range);

request.onsuccess = function() {
  console.log('匹配记录数：', request.result); // 如 12
};
request.onerror = function() {
  console.error('计数失败：', request.error);
};

注意索引的唯一性与多值特性

这里有一个关键细节需要注意：如果索引是多值索引（即创建时设置了multiEntry: true），那么一个对象可能会因其数组字段生成多个索引条目。此时，count()统计的是匹配的“索引条目数”，而非原始的对象个数。

立即学习“前端免费学习笔记（深入）”；

• 例如：一个对象{ tags: ['a', 'b'] }，在tags这个多值索引下，会对应‘a’和‘b’两个键。如果查询范围同时包含‘a’和‘b’，count()返回的结果将是2。
• 若业务上需要统计的是“独立对象”的数量，则需改用游标遍历并手动去重——但这通常不推荐，因为性能开销较大。
• 因此，一个实用的建议是：除非业务逻辑明确需要统计索引条目本身的数量，否则应尽量避免对多值索引进行精确的计数操作。

兼容性与错误处理要点

从兼容性来看，count()方法已获得广泛支持，主流的现代浏览器（如Chrome 24+、Firefox 20+、Edge 12+）以及Safari 10.1+（对应iOS 10.3+）均已实现。不过，为了代码更健壮，以下几点仍需留意：

• 在极少数需要兼容老旧环境的情况下，建议先检查index.count是否为可用函数，并做好兜底准备。
• 如果传入的键范围无效（如下限值大于上限值）、指定的索引不存在，或事务已被中止，则会触发request.onerror事件。
• 事务的活跃状态至关重要。务必确保在调用count()时，相关事务未提前结束，也未因作用域问题而失效。

替代方案：仅当 count() 不可用时考虑

若遇到不支持count()的极低版本浏览器（如老旧的IE或Safari），可考虑使用游标手动计数作为备用方案。但需注意，此方法开销较大，处理不当易阻塞主线程：

• 调用index.openCursor(range)打开一个游标。
• 在游标的onsuccess事件处理器中，手动累加计数器，然后调用cursor.continue()继续遍历。
• 重复此过程，直到event.target.result为null，表示遍历结束。
• 采用此方案时，需特别注意控制游标数量，防止内存溢出。一个可行的优化策略是为游标设置limit或进行分页处理。