IndexedDB记录本身不自动按字段值排序,排序取决于索引与游标配合:主键决定对象存储默认升序排列,索引提供其他排序维度,游标控制遍历方向。

IndexedDB 中的记录本身不自动按字段值排序,排序行为完全取决于你如何使用索引和游标——不是数据“被排好序存着”,而是你“按某种顺序去读它”。关键在于:索引定义了可排序的维度,游标决定了遍历方向,两者配合才产生有序结果。
主键决定对象仓库默认顺序
每个对象存储(Object Store)内部的数据天然按键(key)升序排列。这个 key 来自 keyPath(如 "id")或 key generator(自增数字)。也就是说,如果你没建额外索引,只用主键读取,那么 openCursor() 默认就是按主键从小到大遍历。
- 主键是数字?→ 按数值升序(0, 1, 2…)
- 主键是时间戳?→ 按时间先后升序(旧→新)
- 主键是字符串(如 "user_10", "user_2")?→ 按字典序("user_10" 在 "user_2" 前,因为 '1'
字段索引提供独立的排序路径
当你为某个字段(比如 "createdAt" 或 "score")创建索引后,就获得了一条新的、以该字段值为键的排序链路。这条链路与主键无关,互不影响。
-
store.createIndex('by-time', 'createdAt')→ 支持按时间升序/降序遍历 -
store.createIndex('by-score', 'score')→ 支持按分数高低遍历 - 多个索引可共存,各走各的排序逻辑,互不干扰
注意:索引本身不改变原始数据存储位置,只是建立了一个“按该字段值排序的映射视图”。
游标方向控制实际输出顺序
有了索引,还得用对游标。调用 index.openCursor(null, 'next') 是升序(小→大),'prev' 是降序(大→小)。这是真正触发有序遍历的操作点。
- 想查“最新10条消息”?→ 在
by-time索引上用direction: 'prev'+cursor.advance(10) - 想查“价格最低的3件商品”?→ 在
by-price索引上用'next'遍历前3项 - 没指定 direction?默认是
'next'
复合索引支持多字段联合排序
如果需要先按类型分组、再按时间排序(如“所有 type='chat' 的消息,按 timestamp 降序”),单字段索引不够用,得建复合索引:
store.createIndex('by-type-time', ['type', 'timestamp'])- 查询时用
IDBKeyRange.bound(['chat', 0], ['chat', Date.now()])限定 type 范围,再配'prev'得到倒序时间结果 - 复合索引的字段顺序很重要:前面字段必须精确匹配或范围查询,后面字段才参与排序

















