HTML5中ObjectStore对象仓库的创建与命名规范

酷伟小哥_3144

酷伟小哥_3144

2026-06-01

961人浏览

原创

indexeddb中object store是数据库的基本数据容器,类似关系型数据库的“表”,必须在upgradeneeded事件中创建,命名需合法且语义明确,支持keypath或autoincrement主键配置,不支持直接重命名或修改结构。

html5中objectstore对象仓库的创建与命名规范

在HTML5的IndexedDB中,并没有名为 ObjectStore 的独立“对象”,而是将 object store(对象仓库) 视为数据库中的基本数据容器。它类似于关系型数据库中的“表”,用于存储结构化数据,但不支持SQL查询,也不具备传统意义上的“对象实例”。创建和命名 object store 是使用 IndexedDB 的关键第一步,直接影响后续数据操作的可维护性与兼容性。

创建 object store 的时机与前提

object store 必须在数据库版本升级时(即在 upgradeneeded 事件处理函数中)创建,不能在数据库已打开后动态新增(除非再次调用 open() 并指定更高版本号触发升级)。未在升级阶段创建的 object store,在后续事务中将不可用。

  • 仅当传入的版本号高于当前数据库版本时,indexedDB.open(dbName, newVersion) 才会触发 upgradeneeded
  • 在该事件回调中,通过 event.target.result.createObjectStore(name, options) 创建
  • 若重复创建同名 object store(且版本未变),会抛出 InvalidStateError

命名规则与实用建议

object store 名称是字符串,由开发者定义,但需遵守以下事实约束和工程实践:

Html2md
Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载
  • 名称区分大小写,"users" 和 "Users" 是两个不同仓库
  • 不能包含控制字符、斜杠(/)、反斜杠(\)、空字符等非法字符;建议只用 ASCII 字母、数字、下划线(_)和短横线(-)
  • 避免使用 JavaScript 保留字(如 class、default、function),虽不报错,但可能引发混淆或工具链问题
  • 推荐采用小写+下划线风格(如 user_profile、app_settings),与多数前端命名习惯一致
  • 名称应体现业务语义,避免泛化(如不用 data、store1),便于协作与调试

常见配置选项说明

创建时可传入 options 对象,最常用的是 keyPath 和 autoIncrement:

  • keyPath: 'id' 表示使用对象的 id 字段作为主键(内键),存入数据时该字段必须存在且唯一
  • autoIncrement: true 表示启用自增主键(外键),此时无需提供 key,系统自动生成递增数字键;常与无 keyPath 配合使用
  • 二者不可同时为真:若设了 keyPath,则 autoIncrement 无效;若启用 autoIncrement,就不能设 keyPath
  • 也可省略 options,此时需在添加数据时显式传入 key(即使用 add(value, key))

删除与重命名的现实限制

IndexedDB 不支持直接重命名或修改已有 object store 的结构。如需调整:

  • 只能通过升级数据库版本,在新版本中创建新名称的 object store
  • 手动迁移旧数据(读出 → 转换 → 写入新 store)
  • 再调用 deleteObjectStore(oldName) 删除旧仓库(同样只能在 upgradeneeded 中执行)
  • 注意:删除后无法恢复,且所有索引、数据一并清除

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

3329

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2368

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1300

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1238

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1376

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2238

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

3620

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

16735

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

549

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 225人学习