返回：唐霜｜书

IndexedDB 中文教程

本文通过对IndexedDB的概念、API进行详解，讲清楚IndexedDB中的事务机制，以及objectStore这个核心概念。和一般的教程不同，这篇文章除了一步一步搭建起一个IndexedDB数据库操作的流程，连接、选择、读取、更新等，而且还把最常用的API接口列举出来，方便开发者在一个地方就可以完成所有查询。

前言

indexedDB 是 html5 标准本文作者：唐霜，转载请注明出处。原创内容，盗版必究。引入的web数据持久化方案之一，现代浏览【作者：唐霜】【本文首发于唐霜的博客】器大多按照标准对其进行了实现，我在新的项【原创不易，请尊重版权】【未经授权禁止转载】目中用到它来作为持久化数据存储，于是详细本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】研究了一番，MDN 上的解释虽然权威，但本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。是由于知识不成体系，细节也讲的不透，所以著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。我打算自己写一篇教程，对 indexed【本文受版权保护】【转载请注明来源】DB 的各个细节进行详解。

IndexedDB 在线视频教程，7个课本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】时让你精通 indexedDB 的操作和【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。理解底层标准设计，助你在前端开发中游刃有【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。余地使用数据存储

【原创内容，转载请注明出处】【转载请注明来源】未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。

为了和读者更贴近，我做了上面这套视频教程，总共7个课时，每天一小时，7天可学完。【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】虽然本文的内容已经覆盖了所有与 inde【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】xedDB 相关的内容，但是视频教程的方本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。式更轻松，而且其中有关概念的部分讲解的更【原创内容，转载请注明出处】【转载请注明来源】详细。掌握一门技术，不需要很长时间，7天未经授权，禁止复制转载。【未经授权禁止转载】就可以。视频教程是付费教程，价格不贵，写【版权所有】唐霜 www.tangshuang.net【作者：唐霜】教程真的不容易，希望大家多支持。

本文作者：唐霜，转载请注明出处。【作者：唐霜】未经授权，禁止复制转载。

架构体系

数据库

【关注微信公众号：wwwtangshua【本文受版权保护】本文版权归作者所有，未经授权不得转载。ngnet】

【未经授权禁止转载】

原创内容，盗版必究。

【本文受版权保护】

objectStore

【访问 www.tangshuang.n【原创不易，请尊重版权】【本文首发于唐霜的博客】et 获取更多精彩内容】

key-value

著作权归作者所有，禁止商业用途转载。

【作者：唐霜】

简单的说，indexedDB 是非关系型本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net数据库，数据组织不像 SQL 数据库一样本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】，有表和字段，indexedDB 里面没著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】有表和字段的概念，它的最小组织单位（un【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netit）是 key-value。在 ind【未经授权禁止转载】【转载请注明来源】exedDB 里，一对 key-valu原创内容，盗版必究。【作者：唐霜】e 就相当于 SQL 数据库里面的一条记转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】录，是数据的最终体现形式。我们通过下面的【作者：唐霜】【版权所有】唐霜 www.tangshuang.net图来阐述 indexedDB 和 SQL【原创内容，转载请注明出处】【本文首发于唐霜的博客】数据库结构体系的不同，以帮助理解。

著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。【本文受版权保护】【原创内容，转载请注明出处】

关系型数据库和非关系型数据库本身有非常大未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net的差别，关系型数据库大致上架构是一致的，未经授权，禁止复制转载。【未经授权禁止转载】但是非关系型数据库的架构各式各样，很不统著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。一。就 SQL DB 和 indexed本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。DB 而言：

本文版权归作者所有，未经授权不得转载。【转载请注明来源】本文版权归作者所有，未经授权不得转载。

在最下面那一层，两者都有 databas【作者：唐霜】未经授权，禁止复制转载。e 的概念，要存储数据，首先要创建一个数本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。据库。

【原创内容，转载请注明出处】

转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。ng.net

【作者：唐霜】

往上一层，两者就有了区别，SQL DB 【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】有表的概念，而 indexedDB 对应【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。的是 objectStore。

著作权归作者所有，禁止商业用途转载。

未经授权，禁止复制转载。

【转载请注明来源】

再往上一层，差别更大，SQL DB 的记著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】录有字段的概念，而 indexedDB 【转载请注明来源】【未经授权禁止转载】的记录直接是键值对。

【转载请注明来源】

【作者：唐霜】

indexedDB 中的 objectS著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】tore 虽然和 SQL DB 中的 t【版权所有，侵权必究】【本文首发于唐霜的博客】able 非常像，但是它们的存储形式却极转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】其不同。objectStore 比 ta【本文受版权保护】原创内容，盗版必究。ble 简单的多。

著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】【关注微信公众号：wwwtangshua【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】ngnet】

数据库

indexedDB 是一个完备模型的数据著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。库，有标准的数据库结构体系。它虽然不是一【原创不易，请尊重版权】【原创内容，转载请注明出处】个运行时服务，而是基于文件的即时存取数据【作者：唐霜】著作权归作者所有，禁止商业用途转载。库，但是仍然可以用其他数据库的模型思维来【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。了解它。在 indexedDB 中，我们【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】可以创建多个数据库，每个数据库有自己独立【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】的空间。

连接数据库

要在 indexedDB 中存储数据，要【作者：唐霜】【转载请注明来源】进行两步操作，第一步连接到某个数据库，第未经授权，禁止复制转载。【版权所有，侵权必究】二步挑选某个 objectStore 进【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。行数据操作。现在讲解连接到 indexe【版权所有】唐霜 www.tangshuang.net【转载请注明来源】dDB 数据库。在 window 对象上【转载请注明来源】【本文首发于唐霜的博客】有一个 indexedDB 对象，直接调本文版权归作者所有，未经授权不得转载。【作者：唐霜】用 open 方法进行打开，如果该数据库【转载请注明来源】本文版权归作者所有，未经授权不得转载。不存在，则创建一个新的数据打开：

const request = window.indexedDB.open('mydb', 1)

open有两个参数：

name：数据库名

本文版权归作者所有，未经授权不得转载。

本文作者：唐霜，转载请注明出处。

version：版本

【本文首发于唐霜的博客】

本文作者：唐霜，转载请注明出处。

数据库版本

上面的version参数对于初学者而言不本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。是很好理解。如果你用过 docker 的【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net话，知道有一个东西叫镜像（image），著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。在镜像的基础上构建自己的容器，可以再创建【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。一个新的镜像，那么这个新的镜像其实就包含著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。了老的镜像。这里的 version 也类未经授权，禁止复制转载。未经授权，禁止复制转载。似，它表示当前的数据库结构的版本。ver【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.netsion 必须是正整数，只能升不能将，只【转载请注明来源】本文版权归作者所有，未经授权不得转载。有当需要进行数据库结构修改的时候，才需要【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。升级 version。

【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。【本文受版权保护】【作者：唐霜】

例如，一开始，version 为 1，创【版权所有，侵权必究】转载请注明出处：www.tangshuang.net建了一些 objectStore，当你需原创内容，盗版必究。原创内容，盗版必究。要添加新的 objectStore 或者原创内容，盗版必究。【原创内容，转载请注明出处】修改某些 objectStore 的时候【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net，就需要升级 version。一个数据库本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】只能在同一时间存在一个 version，原创内容，盗版必究。【未经授权禁止转载】不能同时存在多个 version。当你的【转载请注明来源】原创内容，盗版必究。 version 升级之后，你还用老的【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。version 去连接数据库，并进行数据转载请注明出处：www.tangshuang.net【版权所有，侵权必究】操作时，会抛出错误。

补充：有同学留言想对这个问题进行深入探讨未经授权，禁止复制转载。【未经授权禁止转载】。我这里说一下我的想法。从项目的开发上讲【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。，我们只会在发布代码时去升级 versi本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】on，而不会在程序运行过程中通过程序去更【未经授权禁止转载】【本文首发于唐霜的博客】改 version，因为一旦用户刷新页面著作权归作者所有，禁止商业用途转载。【本文受版权保护】，这个 version 会变成代码中设置【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。的 version，这会造成错误。我们升【作者：唐霜】【关注微信公众号：wwwtangshuangnet】级 version，是为了对数据库结构进【本文受版权保护】著作权归作者所有，禁止商业用途转载。行修改，触发 onupgradeneeded 方法。
【关注微信公众号：wwwtangshua转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netngnet】未经授权，禁止复制转载。转载请注明出处：www.tangshua【未经授权禁止转载】【版权所有，侵权必究】ng.net【未经授权禁止转载】
在MDN里面有这样一句话：When you call open()本文作者：唐霜，转载请注明出处。【转载请注明来源】 with a greater vers原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】ion than the actual 【作者：唐霜】转载请注明出处：www.tangshuang.netversion of the datab【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】ase, all other open 【版权所有，侵权必究】【原创内容，转载请注明出处】databases must expli【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.netcitly acknowledge th【作者：唐霜】原创内容，盗版必究。e request before you转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net can start making ch原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。anges to the databas著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。e (an onblocked even转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。t is fired until the【本文受版权保护】本文版权归作者所有，未经授权不得转载。y are closed or relo【版权所有，侵权必究】转载请注明出处：www.tangshuang.netaded). 也就是说，1. 你要传入一个更大当版本【作者：唐霜】著作权归作者所有，禁止商业用途转载。来触发 onupgradeneeded，【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】2. 在数据库处于 open 状态时，对本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】数据库对修改是被 block 住，直到它【作者：唐霜】著作权归作者所有，禁止商业用途转载。被 close 或 reload 之后，转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。这些修改才会生效。
本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】

【转载请注明来源】【作者：唐霜】本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】

未经授权，禁止复制转载。【未经授权禁止转载】【作者：唐霜】转载请注明出处：www.tangshua【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.netng.net

当你需要修改 objectStore 时

本文作者：唐霜，转载请注明出处。

原创内容，盗版必究。

未经授权，禁止复制转载。

当你需要添加新的 objectStore转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】时

【原创不易，请尊重版权】

原创内容，盗版必究。

著作权归作者所有，禁止商业用途转载。

【未经授权禁止转载】

从代码的层面来看，并非这两个事情发生才触【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】发了 version 的改变，恰恰相反，原创内容，盗版必究。本文作者：唐霜，转载请注明出处。如果你要修改或添加 objectStor转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。e，你必须通过传递新的 version 【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。参数到 open 方法中，触发 onupgradeneeded，在 on原创内容，盗版必究。本文作者：唐霜，转载请注明出处。upgradeneeded 的回调函数中转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】才能实现目的。

【本文受版权保护】【访问 www.tangshuang.n转载请注明出处：www.tangshuang.net原创内容，盗版必究。et 获取更多精彩内容】【原创不易，请尊重版权】

获得 db 容器

怎么从上面的 open 方法之后，获得可转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】以用来进行操作的数据库对象容器：

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】【访问 www.tangshuang.n【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】et 获取更多精彩内容】

const request = window.indexedDB.open('mydb', 1)
request.onsuccess = e => {
  const db = e.target.result
}

这是一个异步的操作，你不能在上面代码之后【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】直接使用 db 变量，而是要在 onsu本文作者：唐霜，转载请注明出处。【未经授权禁止转载】ccess 的函数体内继续写代码。而且本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】indexedDB 的所有编程都是这样，本文作者：唐霜，转载请注明出处。【转载请注明来源】这会导致嵌套层层加深，因此，我们这篇文章转载请注明出处：www.tangshuang.net【作者：唐霜】后面还会提供使用 Promise 进行封【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。装的类，使用该类你无需做复杂的操作。

objectStore

objectStore 是 indexe本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。dDB 中非常核心的概念，它是数据的存储【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】仓库，一个 objectStore 类似【原创内容，转载请注明出处】【版权所有，侵权必究】于 SQL 数据库中的表，存放着相关的所著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。有数据记录。

转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。ng.net未经授权，禁止复制转载。【原创不易，请尊重版权】

什么是 objectStore？

indexedDB 是 key-valu【本文首发于唐霜的博客】【原创不易，请尊重版权】e 数据库，具体体现就是 objectS【作者：唐霜】本文作者：唐霜，转载请注明出处。tore. objectStore 是【本文受版权保护】未经授权，禁止复制转载。indexedDB 的数据存储机制，和【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。SQL 的表的地位一致。每一条记录包含了未经授权，禁止复制转载。原创内容，盗版必究。 key 和 value。

未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。

indexedDB 之所以将自己的存储机【转载请注明来源】【关注微信公众号：wwwtangshuangnet】制称为 objectStore，在 st【未经授权禁止转载】【作者：唐霜】ore 前面加上 object，是因为它【原创内容，转载请注明出处】未经授权，禁止复制转载。所存储的记录的集合，就像一个 objec【本文受版权保护】【作者：唐霜】t 一样，是一个 key-value 的【原创不易，请尊重版权】原创内容，盗版必究。集合。

未经授权，禁止复制转载。原创内容，盗版必究。【本文受版权保护】

什么是 key？

key 是 value 的标记值。

原创内容，盗版必究。【访问 www.tangshuang.n本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。et 获取更多精彩内容】转载请注明出处：www.tangshua【本文首发于唐霜的博客】【本文受版权保护】ng.net

但和 localStorage 不同，i【本文首发于唐霜的博客】【作者：唐霜】ndexedDB 的 key 有两种形态原创内容，盗版必究。【原创不易，请尊重版权】：inline 和 outline。in未经授权，禁止复制转载。【本文受版权保护】line key 是指 key 被包含在【版权所有】唐霜 www.tangshuang.net【转载请注明来源】 value 中，例如你存储的 valu转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。e 是对象时，就可以将 key 包含在本文版权归作者所有，未经授权不得转载。【转载请注明来源】value 中。outline key 未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。则是不被包含在 value 中，例如你存【转载请注明来源】【版权所有】唐霜 www.tangshuang.net储的是字符串，或者 ArrayBuffe【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】r，就不可能在 value 中包含 ke原创内容，盗版必究。【本文受版权保护】y，这种情况下通过开启 autoIncr本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。ement 来实现，下文会详细介绍。

转载请注明出处：www.tangshua【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。ng.net【作者：唐霜】原创内容，盗版必究。原创内容，盗版必究。

转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。【转载请注明来源】ng.net本文版权归作者所有，未经授权不得转载。【转载请注明来源】转载请注明出处：www.tangshua【作者：唐霜】【原创内容，转载请注明出处】ng.net

上图中上面一条记录的 value 是一个未经授权，禁止复制转载。原创内容，盗版必究。对象，key 来自对象的 id 属性值，【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】这个 key 是 inline key。本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】下面一条记录，value 是一个字符串，【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.netkey 是由系统自动生成，这个 key 本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。是 outline key。

原创内容，盗版必究。【未经授权禁止转载】【访问 www.tangshuang.n转载请注明出处：www.tangshuang.net原创内容，盗版必究。et 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。

例如有一个值是 { body: { color: 'red' } } 而 keyPath 为 body.color，那么就可以得到 key 为 red。这可能和我们以前理解的地方有所不同。在【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。 IndexedDB 中，我们要通过 r【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】ed 去找到这个值。

原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。

什么是 keyPath？

{
  books: [
    { name: 'My Uncle Tom', price: 13.4 }
  ],
}

其中我要获得第一本书的价格，那么它的 k【本文首发于唐霜的博客】【本文受版权保护】eyPath 就是 ‘boo【本文首发于唐霜的博客】【作者：唐霜】ks[0].price’。它【原创不易，请尊重版权】【作者：唐霜】是一个字符串，但可以用来表达获得一个节点转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。值的属性路径。所以，keyPath 这个本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】单词中的 path 就是这个意思。

【访问 www.tangshuang.n原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】et 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】

key 和 keyPath 的联系

keyPath 的作用是读取 key。

【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。

key 是 value 的 keyPat转载请注明出处：www.tangshuang.net【作者：唐霜】h 的值。
【原创不易，请尊重版权】转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。原创内容，盗版必究。ng.net【本文受版权保护】

原创内容，盗版必究。未经授权，禁止复制转载。【原创不易，请尊重版权】【转载请注明来源】

这句话的意思是：1. value 是一个【原创内容，转载请注明出处】【转载请注明来源】对象，2. 以 keyPath 作为属性【本文首发于唐霜的博客】【本文首发于唐霜的博客】路径从 value 中读取某个节点的值；著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。3. 这个值就是 key。当然，这里面有原创内容，盗版必究。【未经授权禁止转载】一些前提条件，例如“value 是一个对【本文首发于唐霜的博客】未经授权，禁止复制转载。象”，不是字符串，“value 存在 k【原创内容，转载请注明出处】【原创内容，转载请注明出处】eyPath，并能读取值”。

一般而言，keyPath 在创建 obj【作者：唐霜】原创内容，盗版必究。ectStore 和 index 的时候【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】就已经确定了，不会改。所以，在实际编程的【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net时候，我们很少会去用 keyPath，而【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】是拿到一个 key 进行操作。

本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。【转载请注明来源】ng.net

对于 outline key 的情况，在【版权所有，侵权必究】【原创不易，请尊重版权】创建 objectStore 时，我们不【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。能传 keyPath，并且开启 auto【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】Increment，indexedDB 【本文首发于唐霜的博客】【转载请注明来源】会默认以 ‘id’著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】; 作为 keyPath，但我们不会用到【作者：唐霜】本文作者：唐霜，转载请注明出处。这个 ‘id’。

本文作者：唐霜，转载请注明出处。【未经授权禁止转载】

可以存储哪些数据类型？

根据 w3c 文档描述，indexedDB 可以存储的数据类型【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net为：

转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。ng.net【作者：唐霜】【未经授权禁止转载】原创内容，盗版必究。

根据 w3c 的描述，凡是能进行序列化的著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。值，都可以被 indexedDB 存储。著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。也就是说，不能被序列化的，例如自引用的【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】object，或者某些类的实例，还有 f【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netunction，就不能被 indexed【原创内容，转载请注明出处】原创内容，盗版必究。DB 存储。简单理解就是，不能存func本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.nettion等非结构化的数据，object必【未经授权禁止转载】本文作者：唐霜，转载请注明出处。须是以键值对组成的字面对象。

原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

创建 objectStore

创建 objectStore 和修改 o原创内容，盗版必究。转载请注明出处：www.tangshuang.netbjectStore 都只能在 db 的 onupgradeneeded 事件中进本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】行，因此，要创建 objectStore【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net，必须在前面的 open 操作那个时候来【作者：唐霜】【转载请注明来源】进行。

const request = window.indexedDB.open('mydb', 1)
request.onupgradeneeded = (e) => {
  const db = e.target.result
  db.createObjectStore('mystore', { keyPath: 'id' })
}
request.onsuccess = (e) => {
  const db = e.target.result
  // ...
}

上面的红色代码中，我们使用 create本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】ObjectStore 方法来实现 ob转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。jectStore 的创建。但是，需要注【转载请注明来源】【作者：唐霜】意的是，一个 database 中，只允【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。许存在一个同名的 objectStore【转载请注明来源】本文作者：唐霜，转载请注明出处。，因此，如果你第二次 createObj本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】ectStore 相同名的objectS本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】tore，程序会报错。比如你的程序如果像【作者：唐霜】未经授权，禁止复制转载。上面这样写，必然会遇到一个问题，就是当你【未经授权禁止转载】【版权所有，侵权必究】更新 version 的时候，会再次执行【未经授权禁止转载】【本文受版权保护】 createObjectStore，那【转载请注明来源】【作者：唐霜】么就会报错，程序就会中断。另一个注意点是著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。，一旦一个 objectStore 被创【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】建，它的 name 和 keyPath 著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net是不能修改的。那么有什么办法来控制呢？通本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。过一个判断，判断是否已经存在同名的 ob转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netjectStore 即可。

const request = window.indexedDB.open('mydb', 1)
request.onupgradeneeded = (e) => {
  const db = e.target.result
  if (!db.objectStoreNames.contains('mystore')) {
    db.createObjectStore('mystore', { keyPath: 'id' })
  }
}
request.onsuccess = (e) => {
  const db = e.target.result
  // ...
}

onupgradeneeded 不会在每【作者：唐霜】【本文首发于唐霜的博客】次刷新页面的时候执行，而是在刷新页面时，本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】indexedDB 发现 version未经授权，禁止复制转载。【本文受版权保护】被升级了的时候执行。因此，所有的数据库【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net结构的东西，都要放在这个函数内去做。

【作者：唐霜】【原创内容，转载请注明出处】

objectStore 创建之后不可修改【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。，如果创建时失误，给了错误的配置，必须先著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。删除该 objectStore 之后，重【转载请注明来源】未经授权，禁止复制转载。新创建。

【关注微信公众号：wwwtangshua未经授权，禁止复制转载。原创内容，盗版必究。ngnet】原创内容，盗版必究。

objectStore 的类型

【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。

对象型仓库

如果一个 objectStore 是用来【本文受版权保护】【转载请注明来源】存对象的，那么这种情况下你应该每次都存入【版权所有】唐霜 www.tangshuang.net【本文受版权保护】一个对象，而且，这个对象有一个属性路径是著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。规定的 keyPath。倘若这个对象不存未经授权，禁止复制转载。未经授权，禁止复制转载。在对应的 keyPath，那么就会报错。

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。【本文受版权保护】【转载请注明来源】

这里的对象不包括数组。

【未经授权禁止转载】【关注微信公众号：wwwtangshua【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】ngnet】

db.createObjectStore('mystore', { keyPath: 'id' })

非对象型仓库

如果一个 objectStore 是用来转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】存非对象的，例如我们经常会考虑用来存 A本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】rrayBuffer，这个时候，你应该在【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】创建 objectStore 的时候，传本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。入配置信息 autoIncrement 【转载请注明来源】【本文受版权保护】为 true，不传 keyPath。

本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。

db.createObjectStore('mystore', { autoIncrement: true })

这种情况下，存入数据（ArrayBuff【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。er）时，key 会被自动添加上，且跟本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】SQL 数据的自增字段一样，索引值会在原【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。有基础上自加 1。在查询或更新值的时候，未经授权，禁止复制转载。【未经授权禁止转载】都要使用这个值作为 key。但是，这种情转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net况下，会有一个问题，key 是在运行时保本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】存在内存中的，一旦用户刷新页面，你就不知【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】道刚刚插入的值的 key 了。对于这种情原创内容，盗版必究。原创内容，盗版必究。况，如果想持久化，可以和 localSt原创内容，盗版必究。原创内容，盗版必究。orage 一起使用来解决。

转载请注明出处：www.tangshua【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。ng.net【原创不易，请尊重版权】转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】ng.net

混合仓库

如果你硬是要在一个 objectStor【原创不易，请尊重版权】【作者：唐霜】e 中混合存值，那么必须按照非对象型仓库【未经授权禁止转载】转载请注明出处：www.tangshuang.net来使用。但是会有一个不一样的地方，当你存【版权所有，侵权必究】【作者：唐霜】入一个对象时，如果该对象中并没有对应的本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。keyPath，那么，它会在存入时被自动本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】加上这个 keyPath。这一点非常奇怪【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。，你会发现，存入 string, Blo【原创内容，转载请注明出处】原创内容，盗版必究。b 和存入 object 的效果竟然不同本文版权归作者所有，未经授权不得转载。【作者：唐霜】。

本文作者：唐霜，转载请注明出处。【作者：唐霜】【原创不易，请尊重版权】【转载请注明来源】

db.createObjectStore('mystore', { keyPath: 'id', autoIncrement: true })

未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。

什么是 autoIncrement？

前面提到过 autoIncrement，转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】但是没有详细解释。这需要涉及到一个叫 key generator 的东西，但是它过于底层，我们这里不深入【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】讲解，你可以自行了解，我们这里做简化说明本文作者：唐霜，转载请注明出处。【本文受版权保护】。autoIncrement 是一个配置本文作者：唐霜，转载请注明出处。【转载请注明来源】。当创建 objectStore 时，如【转载请注明来源】【关注微信公众号：wwwtangshuangnet】果 autoIncrement 被设置为转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。 true，那么它的 key 将具备自动未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net生成的能力。

【关注微信公众号：wwwtangshua【本文受版权保护】本文版权归作者所有，未经授权不得转载。ngnet】转载请注明出处：www.tangshua【原创内容，转载请注明出处】【作者：唐霜】ng.net【本文首发于唐霜的博客】

什么是自动生成？

【作者：唐霜】【转载请注明来源】【作者：唐霜】【访问 www.tangshuang.n【本文受版权保护】本文作者：唐霜，转载请注明出处。et 获取更多精彩内容】

当存入的值不存在对应的 keyPath 本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】时，自动创建 keyPath，并用一个自【转载请注明来源】原创内容，盗版必究。动生成的数字作为 key，这个动作被成为转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】“污染”

【未经授权禁止转载】

自动生成的数字从 1 开始自增长，每次加【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】 1

【原创内容，转载请注明出处】

本文作者：唐霜，转载请注明出处。

本文版权归作者所有，未经授权不得转载。

当用户手动传入 key 时，如果是一个数原创内容，盗版必究。【作者：唐霜】字，自增长的值会被覆盖，下次插入时，会从原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net新的值开始计算

原创内容，盗版必究。

著作权归作者所有，禁止商业用途转载。

【原创内容，转载请注明出处】

如果手动传入的 key 不是数字，那么不【原创不易，请尊重版权】原创内容，盗版必究。影响 key 的自增长，下次插入仍然以之本文版权归作者所有，未经授权不得转载。【转载请注明来源】前的值作为基底

本文版权归作者所有，未经授权不得转载。

本文作者：唐霜，转载请注明出处。

它的最大取值范围为 2⁵³，超出时，继续享受自增长会报错，但可以通未经授权，禁止复制转载。【本文受版权保护】过自己给明确的字符串 key 继续添加记【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】录

原创内容，盗版必究。

【作者：唐霜】

在一条记录被插入时，add 或 put 本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net方法会返回该记录的 key

【转载请注明来源】

本文版权归作者所有，未经授权不得转载。

对于非对象的存入值，不会产生污染效果

转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net原创内容，盗版必究。ng.net

对于对象型仓库，如果新增的值不存在对应的【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。 key，那么被存的值会被“污染”。标准本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。文档中是这么说的：“Then the v【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】alue provided by the本文作者：唐霜，转载请注明出处。原创内容，盗版必究。 key generator is us原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】ed to populate the k【版权所有，侵权必究】【原创不易，请尊重版权】ey value.”也就是说，你在取出这【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】个值的时候，这个 key 被添加到了值上原创内容，盗版必究。【转载请注明来源】，也就是说，存入的值被改了（添加了属性）未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。。

【原创内容，转载请注明出处】【未经授权禁止转载】原创内容，盗版必究。

对于我们开发者而言，一般的建议是，如果你【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。的 objectStore 用于存储对象【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】，尽量不要开启 autoIncremen【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】t 功能。只有在储存非对象值时，一定要开【本文受版权保护】原创内容，盗版必究。启 autoIncrement 功能。不【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net建议使用混合型仓库。

index

索引是 indexedDB 中最值得玩味【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】的部分，这也是它取名“indexedDB原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。”的原因。索引，是一系列概念的统称：

【本文受版权保护】本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。

用于存储索引的空间被称为“索引”，例如我著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。们可以称 objectStore 的一个【转载请注明来源】【本文受版权保护】索引

未经授权，禁止复制转载。

某条记录的索引也被称为“索引”，例如我们本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】可以称 value 的 indexNam未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】e 索引

著作权归作者所有，禁止商业用途转载。

未经授权，禁止复制转载。

简单的说，索引是独立于 objectSt【未经授权禁止转载】未经授权，禁止复制转载。ore 之外，但又和 objectSto【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。re 绑定的，用于建立更多查询线索的工具【本文受版权保护】转载请注明出处：www.tangshuang.net。

什么是 index？

本质上，一个 index 是一个特殊的著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】objectStore，它的存储结构和著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。objectStore 基本一致，也有自【本文首发于唐霜的博客】【转载请注明来源】己的 name（本文标记为 indexN本文作者：唐霜，转载请注明出处。原创内容，盗版必究。ame）, keyPath, key 和【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。 value。特殊之处在于，索引的 ke本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。y 具有一定的逻辑约束，例如 uniqu转载请注明出处：www.tangshuang.net原创内容，盗版必究。e 用于规定该 key 是唯一的。

转载请注明出处：www.tangshua【本文首发于唐霜的博客】【原创不易，请尊重版权】ng.net本文版权归作者所有，未经授权不得转载。【转载请注明来源】

本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】

上图是一个 index 存储器的示意图，著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】一个 objectStore 可以有多个【本文受版权保护】本文作者：唐霜，转载请注明出处。 index 和自己绑定。

【转载请注明来源】【作者：唐霜】【原创不易，请尊重版权】

index 和 objectStore 的关系

index 依附于 objectStor未经授权，禁止复制转载。转载请注明出处：www.tangshuang.nete。我们在创建索引时，首先要得到一个 o【版权所有】唐霜 www.tangshuang.net【作者：唐霜】bjectStore，再在这个 obje【本文受版权保护】【本文首发于唐霜的博客】ctStore 的基础上创建一个索引。一未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net个 objectStore 可以有多个索【转载请注明来源】原创内容，盗版必究。引。

【作者：唐霜】本文版权归作者所有，未经授权不得转载。【转载请注明来源】【作者：唐霜】

index 的 key 和 value 【本文首发于唐霜的博客】【原创内容，转载请注明出处】全部来自 objectStore。key【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.net 为某条记录的 keyPath（inde【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】x.keyPath）的值，value 为本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】这条记录的 key（objectStor转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】e.key）。index 中的一条记录自【本文首发于唐霜的博客】原创内容，盗版必究。动和 objectStore 中的对应记【本文受版权保护】【原创不易，请尊重版权】录绑定，当 objectStore 中的转载请注明出处：www.tangshuang.net【转载请注明来源】记录发生变化时，index 中的记录会自【作者：唐霜】【版权所有】唐霜 www.tangshuang.net动被污染（自动更新）。

【作者：唐霜】【本文首发于唐霜的博客】

index 实际上是对 objectSt【作者：唐霜】【本文首发于唐霜的博客】ore 查询条件的补充。如果没有 ind【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。ex，我们只能通过 objectStor著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】e 的 key 来查值，但是有了 ind【版权所有，侵权必究】【版权所有，侵权必究】ex，我们可以查询的能力被扩展到了任意属转载请注明出处：www.tangshuang.net原创内容，盗版必究。性路径。

未经授权，禁止复制转载。【未经授权禁止转载】【原创内容，转载请注明出处】【原创不易，请尊重版权】

如何创建索引？

未经授权，禁止复制转载。原创内容，盗版必究。未经授权，禁止复制转载。【本文受版权保护】

let request = window.indexedDB.open('mydb', 1)
request.onupgradeneeded = e => {
  let db = e.target.result
  let objectStore = db.createObjectStore('mystore', { keyPath: 'id' }) //注意这里应该进行判断是否已经存在这个 objectStore，我是为了省事
  objectStore.createIndex('price', 'book.price', { unique: false })
}

objectStore 对象有一个 cr【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.neteateIndex 方法，它可以创建索引著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net。它有三个参数，第一个参数是这个索引的本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】indexName，第二个参数是 key原创内容，盗版必究。转载请注明出处：www.tangshuang.netPath，第三个参数是 options，【作者：唐霜】【版权所有】唐霜 www.tangshuang.net其中 unique 选项被放在这里面。

著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】

如何修改索引？

虽然 objectStore 本身的信息【未经授权禁止转载】未经授权，禁止复制转载。是不能修改的，比如 name 和 key本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】Path 都是不能修改的，但是它所拥有的【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】索引可以被修改，修改其实就是删除+添加操本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。作。用到的就是 deleteIndex 转载请注明出处：www.tangshuang.net【本文受版权保护】这个方法，所以，如果你想修改一个索引，要【原创内容，转载请注明出处】【作者：唐霜】做的就是先删除掉原来的同名索引，然后添加【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。新的索引。举个例子，如果你知道数据库中已【本文首发于唐霜的博客】未经授权，禁止复制转载。经存在 mystore 这个 objec本文版权归作者所有，未经授权不得转载。【作者：唐霜】tStore 了：

request.onupgradeneeded = (e) => {
  const objectStore = e.target.transaction.objectStore('mystore')
  const indexNames = objectStore.indexNames
  if (indexNames.contains('name')) {
    objectStore.deleteIndex('name')
  }
  objectStore.createIndex('name', 'name', { unique: false })
}

索引的运行机制

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。

例如，你在创建索引的时候，是这样创建的：

objectStore.createIndex('indexName', 'index.keyPath', { unique: false })

在根据索引进行查询的时候，语法是这样的：

【本文首发于唐霜的博客】【作者：唐霜】

const request = objectStore.index('indexName').get('indexKey')

这实际上是两个过程，第一个过程是在保存数【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。据时（包括创建和更新），索引区会同步更新转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。自己的 key，它包含如下步骤：

遍历该 objectStore 的所有索本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】引

著作权归作者所有，禁止商业用途转载。

读取索引的 keyPath，我们这里标记【本文受版权保护】本文作者：唐霜，转载请注明出处。为 indexKeyPath

本文作者：唐霜，转载请注明出处。

【本文受版权保护】

如果是更新某个值，遍历索引区记录，找到引【原创内容，转载请注明出处】原创内容，盗版必究。用该值的索引记录^[1]

【未经授权禁止转载】

原创内容，盗版必究。

【本文受版权保护】

解析得到被存入的值的 indexKeyP本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】ath，得到目标值，这个值即索引将要使用【原创不易，请尊重版权】【未经授权禁止转载】的 key，我们标记为 indexKey

转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。ng.net

索引 indexKey 的条件判断，例如【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】，检查是否满足 unique 要求，不满【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。足的情况下，抛出错误提示

著作权归作者所有，禁止商业用途转载。

【本文受版权保护】

转载请注明出处：www.tangshua【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】ng.net

更新索引记录的 key 为 indexK【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】ey

【作者：唐霜】

未经授权，禁止复制转载。

第二个过程是查询过程，.index('indexName') 这个动作就是从名字为 indexNam转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。e 的索引区去进行索引查询，.get('indexKey') 这个动作包含了好几步：

【原创不易，请尊重版权】未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。

连接到名字为 ‘indexN【作者：唐霜】【作者：唐霜】ame’ 的索引区

【原创内容，转载请注明出处】

在索引区中查询索引 key 为 R【未经授权禁止转载】【版权所有】唐霜 www.tangshuang.net16;indexKey’ 的【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】索引记录

【原创不易，请尊重版权】

得到该记录后，读取记录的 value

【本文受版权保护】

【本文首发于唐霜的博客】

【作者：唐霜】

将该 value 作为 objectSt【转载请注明来源】【作者：唐霜】ore 的 key 到 objectSt【本文首发于唐霜的博客】【本文首发于唐霜的博客】ore 中进行查询

【本文首发于唐霜的博客】

【转载请注明来源】

本文作者：唐霜，转载请注明出处。

【本文受版权保护】

找到第一个结果时，直接返回

【本文受版权保护】

【未经授权禁止转载】

将放回的结果作为索引查询的最终结果

【访问 www.tangshuang.n【原创不易，请尊重版权】【作者：唐霜】et 获取更多精彩内容】

本文作者：唐霜，转载请注明出处。

著作权归作者所有，禁止商业用途转载。

从某种意义上讲，索引查询的性能肯定不如直【本文首发于唐霜的博客】【本文首发于唐霜的博客】接通过 objectStore 的 ke本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.nety 查询。

【关注微信公众号：wwwtangshua本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。ngnet】本文作者：唐霜，转载请注明出处。

^[1] 在索引中，存在一个叫 referenced value 的东西，即一个索引建立的时候，会自动引【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net用 objectStore 中对应的记录【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。。所以，对于开发者，不用担心索引是如何去转载请注明出处：www.tangshuang.net【版权所有，侵权必究】快速找到它在 objectStore 的【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】对应记录的。

【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】

什么是 unique？

默认情况下，index 的 key 是可【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】以重复的。所有的值被存在 objectS【访问 www.tangshuang.net 获取更多精彩内容】【版权所有，侵权必究】tore 中，但是所有值除了 objec【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。tStore 中规定的 keyPath 未经授权，禁止复制转载。【版权所有，侵权必究】必须唯一之外，默认情况下，其他属性可以相著作权归作者所有，禁止商业用途转载。【本文受版权保护】同。但是，如果你建立的索引传入了 uni原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.netque 参数，那么情况就会发生变化。也就著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。是说，该索引的 keyPath 被用于检著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】查存入的值对应的 keyPath 是否已本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。经有值，如果 objectStore 中【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】存在该 keyPath 的值为将要存入的【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net值的该 keyPath 值，那么会抛出错本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】误。

【作者：唐霜】未经授权，禁止复制转载。

transaction

所有结构完备的数据库中都有“事务”这个概【原创内容，转载请注明出处】【原创内容，转载请注明出处】念，它是为了确保当并非执行某些操作时，不原创内容，盗版必究。【未经授权禁止转载】致混乱。举个简单的例子，当你在像好友打钱【作者：唐霜】本文版权归作者所有，未经授权不得转载。的时候，发起了一个请求，这个请求发起后，本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】就建立了你打钱的事务，后面一大堆数据库写【作者：唐霜】【未经授权禁止转载】入的操作，但是，假如中间突然机房停电，银本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。行系统发生故障，你又发起了第二个打钱的请转载请注明出处：www.tangshuang.net【本文受版权保护】求，那么会不会有这样一种可能，你第一次打【本文受版权保护】未经授权，禁止复制转载。出去的钱你朋友根本没收到？数据库系统为了未经授权，禁止复制转载。【本文首发于唐霜的博客】避免这种情况，采用事务机制，如果出错，那【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】就回滚，把你打出去但对方没收到的钱回到你转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。账上，重新再执行一次打钱的操作，执行完这本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。个操作之后，再执行你第二次打钱的操作。这未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】样就保证了数据库增删改有序不混乱。

未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【原创不易，请尊重版权】

什么是 transaction？

indexedDB 里面的事务，保证了所【本文首发于唐霜的博客】【原创内容，转载请注明出处】有操作（特别是写入操作）是按照一定的顺序【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】进行，不会导致同时写入的问题。另外，in【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】dexedDB 里面，强制规定了，任何读【作者：唐霜】著作权归作者所有，禁止商业用途转载。写操作，都必须在一个事务中进行。从前面的【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。代码里面你也看到了，对 objectSt转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。ore 的修改，其实也是在一个事务中进行未经授权，禁止复制转载。原创内容，盗版必究。。

本文版权归作者所有，未经授权不得转载。【作者：唐霜】本文作者：唐霜，转载请注明出处。

特别是写操作，事务通过尝试性写入完成第一转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net步更新，如果整个尝试过程没有出错，那么会【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。通过一个 commit 操作使得整个更新【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。生效。但是如果在尝试过程中出错了，就会进本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net行一个 abort 操作，之前做过的尝试未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net会直接被丢弃，数据不会发生改变。一个 o【本文首发于唐霜的博客】未经授权，禁止复制转载。bjectStore 的写入过程中，另外本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】一个写入操作会被挂起，直到上一个事务完成未经授权，禁止复制转载。未经授权，禁止复制转载。。

【未经授权禁止转载】原创内容，盗版必究。本文作者：唐霜，转载请注明出处。

如何使用 transaction？

在代码层面，我们必须通过 transac【作者：唐霜】本文作者：唐霜，转载请注明出处。tion 方法，向数据库容器提出事务要求转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。，才能往具体的 objectStore 【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】进行数据处理：

let transaction = db.transaction(['myObjectStore'], 'readonly')
let objectStore = transaction.objectStore('myObjectStore')
let request = objectStore.get('111')

上面这段代码的操作，我们得到了具体要进行本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net操作的 objectStore，这和我们未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。预期直接通过 db.objectStore('myObjectStore') 这样简洁的方法完全不同，indexed【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】DB 中不能这么直接去获取 object著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。Store，而必须通过 transact【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】ion。

【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。

transaction 方法有两个参数：

转载请注明出处：www.tangshua原创内容，盗版必究。原创内容，盗版必究。ng.net【原创不易，请尊重版权】

objectStores：事务打算对哪些著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】 objectStore 进行操作，因此【原创内容，转载请注明出处】【本文首发于唐霜的博客】是一个数组

【未经授权禁止转载】

本文版权归作者所有，未经授权不得转载。

mode：对进行操作的 objectSt【本文受版权保护】原创内容，盗版必究。ore 的模式，即读写权限控制， rea【版权所有，侵权必究】【原创内容，转载请注明出处】donly | readwrite

【本文首发于唐霜的博客】

未经授权，禁止复制转载。

著作权归作者所有，禁止商业用途转载。

而通过 transaction 的 ob【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】jectStore 方法可以获取想要操作【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。的 objectStore，但是它的参数著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。必须存在于上面的 objectStore【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】s 数组中，毕竟你的这个事务已经规定了要【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net对哪些 objectStore 进行操作转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】。

因为 objectStore 是在事务中【原创内容，转载请注明出处】【本文首发于唐霜的博客】获取，因此一个 objectStore 转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】实例，如果有一个 transaction【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。属性的话，那么可以通过这个属性找出它的原创内容，盗版必究。【版权所有，侵权必究】事务的实例。在 indexedDB 中，转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net你只能在事务中得到一个 objectSt未经授权，禁止复制转载。原创内容，盗版必究。ore 实例，如果通过 db 的话，最多本文版权归作者所有，未经授权不得转载。【本文受版权保护】只能得到 objectStore 的名字【本文受版权保护】【版权所有，侵权必究】列表，要获得 objectStore 的【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】实例，必须在 transaction 中本文作者：唐霜，转载请注明出处。【未经授权禁止转载】。

著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。

补充：由于js是单线程运行程序，所以对于本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】所有事务而言，也是有先后顺序的，只有当某著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。些事务完成之后，才会进入后面当事务，因此本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。即使一个 objectStore 存在于本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。多个事务中，它也会按照事务出现当先后顺序未经授权，禁止复制转载。【本文首发于唐霜的博客】被操作，而不是被不同当事务交叉操作。另外【转载请注明来源】【原创内容，转载请注明出处】，对一个 objectStore 的写入【原创内容，转载请注明出处】【原创内容，转载请注明出处】操作的事务只允许存在一个，它会自动根据你本文作者：唐霜，转载请注明出处。【作者：唐霜】传入的 mode 值为 readwrit【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。e 时进行判断和报错。
转载请注明出处：www.tangshua【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.netng.net本文版权归作者所有，未经授权不得转载。【本文受版权保护】

【未经授权禁止转载】【本文受版权保护】转载请注明出处：www.tangshua【本文受版权保护】【本文首发于唐霜的博客】ng.net【原创不易，请尊重版权】

事务生命周期

知道有事务的存在之后，一定要注意 indexedDB 事务的生【版权所有，侵权必究】【未经授权禁止转载】命周期。一个事务，它会把你在它的生命周期里面规本文作者：唐霜，转载请注明出处。原创内容，盗版必究。定的操作全部执行，一旦执行完，周期结束，本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】那么事务就关闭了，你不能再利用这个事务的本文版权归作者所有，未经授权不得转载。【作者：唐霜】实例进行下一步操作。

【转载请注明来源】【未经授权禁止转载】【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。

举一个错误的例子：

var tx
var objectStore
var request = indexedDB.open('name', 1)
requst.onsuccess = function(e) {
  var db = e.target.result
  tx = db.transaction(["MyOBJ"],"readwrite")
  objectStore = tx.objectStore("MyOBJ")
}
btn.onclick = function() {
  objectStore.add({}) // 这时会报错，因为生命周期已经结束了，你不能在这里使用 tx 或 objectStore
}

上面灰色的代码是一个错误的使用思路。写代【本文受版权保护】本文版权归作者所有，未经授权不得转载。码的人想在全局某个地方创建了一个事务，并本文作者：唐霜，转载请注明出处。原创内容，盗版必究。用一个变量保存起来，好在后续操作中使用。原创内容，盗版必究。转载请注明出处：www.tangshuang.net但是，indexedDB 中，事务会在非原创内容，盗版必究。转载请注明出处：www.tangshuang.net常短的时间里面循环检查自己，当发现自己内未经授权，禁止复制转载。【作者：唐霜】部已经没有任何任务要做的时候，就将自己关本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。闭。要深入了解这一点，你需要了解 jav【转载请注明来源】【原创不易，请尊重版权】ascript 调用栈、事件循环的知识，著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。可能有点复杂。

总之，你可以把 indexedDB 里面本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。的事件想象成时间非常短（1ms）的 de【转载请注明来源】转载请注明出处：www.tangshuang.netbounce，如果在这个 1ms 里面，【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】没有新的任务要做，它就关闭了，不能再被使【关注微信公众号：wwwtangshuangnet】【作者：唐霜】用。所以，上面正确的代码应该是：

转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。ng.net【原创不易，请尊重版权】

btn.onclick = function() {
  var request = indexedDB.open('name', 1)
  requst.onsuccess = function(e) {
    var db = e.target.result
    var tx = db.transaction(["MyOBJ"],"readwrite")
    var objectStore = tx.objectStore("MyOBJ")
    var request = objectStore.add({ ... })
  }
}

即在每一次发生 click 事件的时候去【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。发起一个事务，再在这个事务中搞事情。

转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net【本文受版权保护】ng.net【转载请注明来源】【未经授权禁止转载】

什么是 request？

我们操作数据，一定是在事务中进行。一个事本文版权归作者所有，未经授权不得转载。【转载请注明来源】务，本质上是控制一个生命周期，用于保证数【版权所有，侵权必究】【本文首发于唐霜的博客】据库读写的可用和安全。但是，真正涉及到如著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】何去存取数据，我们需要发起一个 requ著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.netest。一个事务过程中，可以有多个 re未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。quest，request 一定存在与事未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】务中，因此它肯定会有一个 transac著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.nettion 属性来获取它所属于的那个事务的【作者：唐霜】【本文首发于唐霜的博客】容器。

为什么要有 request 呢？你可以把著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。 transaction 当做一个队列，未经授权，禁止复制转载。【未经授权禁止转载】在这个队列中，request 在进行排队【未经授权禁止转载】【本文受版权保护】，每一个 request 都只包含一个操【转载请注明来源】【版权所有】唐霜 www.tangshuang.net作，比如添加，修改，删除之类的。这些操作【作者：唐霜】【原创内容，转载请注明出处】不能马上进行，比如修改操作，如果你马上进【作者：唐霜】本文作者：唐霜，转载请注明出处。行，就会导致大家同时修改怎么办的问题，把【作者：唐霜】【原创内容，转载请注明出处】多个修改操作放在 request 中，这【未经授权禁止转载】【版权所有，侵权必究】些 request 在 transact【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。ion 中排队，一个一个处理，这样就会有著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net执行的顺序，修改就有前后之分。同时，tr本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】ansaction 都可以被 abort【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】，这样当一系列的操作被放弃之后，后续的操【原创不易，请尊重版权】【未经授权禁止转载】作也不会进行。

而且非常重要的思想是，request 是本文作者：唐霜，转载请注明出处。【转载请注明来源】异步的，它有状态，一个 request 【未经授权禁止转载】【原创内容，转载请注明出处】处于什么状态，可以通过 readyStates 属性查到，这对开发者而言也更可控。

目前，在 indexedDB 中，有四种原创内容，盗版必究。【作者：唐霜】可能产生 request：open da本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.nettabase，objectStore r【原创不易，请尊重版权】原创内容，盗版必究。equest, cursor reque本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】st, index request。

著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshua【原创不易，请尊重版权】未经授权，禁止复制转载。ng.net

cursor

虽然 indexedDB 使用 obje原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】ctStore 存储数据，是一个 key【未经授权禁止转载】【本文首发于唐霜的博客】-value 数据库。但是，我们有遍历所【本文首发于唐霜的博客】【版权所有，侵权必究】有记录的需求。cursor 游标，就是未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。indexedDB 提供的遍历整个 ob【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】jectStore 的能力接口。

【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。

什么是 cursor？

概念上讲，游标是“一个用来记录数组正在被未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】操作的某个下标位置的迭代器”。举个例子，本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。你有一个数组 [1,2,3,4]，现在你未经授权，禁止复制转载。【原创内容，转载请注明出处】要对它进行遍历，使用 forEach 方【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net法，那么 forEach 方法怎么知道你未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。上次操作到第几个元素，现在应该操作第几个【本文首发于唐霜的博客】【原创不易，请尊重版权】元素呢？它通过内部的一个迭代器实现。游标本文作者：唐霜，转载请注明出处。【版权所有】唐霜 www.tangshuang.net本质上是一个迭代器，也就意味着有类似于【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。next 的方法，可以用来移动游标到下一【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。个位置，有 value 属性用来读取当前【本文首发于唐霜的博客】【作者：唐霜】值。当然，游标不能理解为纯粹的迭代器，因【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】为它的内部过程需要进行 I/O 操作。

【原创不易，请尊重版权】【本文首发于唐霜的博客】

获取全部 object

想要获取一个 objectStore 中【本文首发于唐霜的博客】【原创不易，请尊重版权】的全部 object 可不是一件简单的事未经授权，禁止复制转载。【版权所有，侵权必究】。indexedDB 1.0 版本的时候【作者：唐霜】转载请注明出处：www.tangshuang.net没有直接提供类似的方法来获取（2.0 已【未经授权禁止转载】【未经授权禁止转载】经提供了 getAll 方法）。那么我们本文作者：唐霜，转载请注明出处。原创内容，盗版必究。应该怎么办呢？利用游标。

【访问 www.tangshuang.n【原创内容，转载请注明出处】【本文受版权保护】et 获取更多精彩内容】本文作者：唐霜，转载请注明出处。【未经授权禁止转载】【访问 www.tangshuang.n【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】et 获取更多精彩内容】

let transaction = db.transaction(['myObjectStore'], 'readonly')
let objectStore = transaction.objectStore('myObjectStore')
let request = objectStore.openCursor()
let results = []
request.onsuccess = e => {
  let cursor = e.target.result
  if (cursor) {
    results.push(cursor.value)
    cursor.continue()
  }
  else {
    // 所有的object都在results里面
  }
}

通过 openCursor 方法开启一个【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】游标，在其 onsuccess 事件中，【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】如果 cursor 没有遍历完所记录，那本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。么通过执行 cursor.continu著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。e() 来让游标滑动到下一个记录，ons著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】ucess 会被再次触发。而如果所有记录【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。都遍历完了，cursor 变量会是 un转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netdefined。

本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。

【原创不易，请尊重版权】【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。

通过 index 查询集合

前文举例过如何通过 index 查询值。本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】但是，在前面的演示代码中，仍然只能得到一本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】个值，加入我们希望通过 index 得到【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。某个 index key 的所有值呢？通【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】过游标就可以实现。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。【转载请注明来源】

let objectStore = db.transaction([storeName], 'readonly').objectStore(storeName)
let objectIndex = objectStore.index('name')
let request = objectIndex.openCursor()
request.onsuccess = e => {
  let cursor = e.target.result
  if (cursor) {
    results.push(cursor.value)
    cursor.continue()
  }
  else {
    // 所有的 object 都在 results 里面
  }
}

【原创内容，转载请注明出处】原创内容，盗版必究。原创内容，盗版必究。

你也可以总结出游标的使用，简单的说，就是【本文受版权保护】本文版权归作者所有，未经授权不得转载。对已知的集合对象（比如 objectSt著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】ore 或 index）进行遍历，在 o【原创不易，请尊重版权】【版权所有，侵权必究】nsuccess 中使用 continu【本文首发于唐霜的博客】【未经授权禁止转载】e 来进行控制。

本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】【作者：唐霜】

数据的存取

当一个事务开始之后，在它的生命周期以内，本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】你可以对 objectStore 进行数【未经授权禁止转载】【版权所有，侵权必究】据操作，数据操作无非是增删改查。前面介绍本文作者：唐霜，转载请注明出处。【本文受版权保护】过如何获取事务中的objectStore原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。，现在，我们就用获取到的objectSt转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】ore进行数据操作。

获取数据

let transaction = db.transaction(['myObjectStore'], 'readonly')
let objectStore = transaction.objectStore('myObjectStore')
let request = objectStore.get('100001')
request.onsuccess = e => {
  let obj = e.target.result
}

的确，在indexedDB事务机制下进行未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】操作是很麻烦的，上面代码中我们使用了ge转载请注明出处：www.tangshuang.net原创内容，盗版必究。t方法获取主键值为100001的obje著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】ct，但是获取过程是一个Request，本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net后文会详细讲Request是什么东东，只【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】有在其onsuccess事件中才能得到获【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。取到的结果。

添加数据

let transaction = db.transaction(['myObjectStore'], 'readonly')
let objectStore = transaction.objectStore('myObjectStore')
let request = objectStore.add({
  id: '100002',
  name: 'Zhang Fei',
})

添加数据使用add方法，传入一个obje本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】ct。但是这个object有限制，它的主转载请注明出处：www.tangshuang.net原创内容，盗版必究。键值，也就是id值，不能是已存在的，如果【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】objectStore中已经有了这个id著作权归作者所有，禁止商业用途转载。【转载请注明来源】，那么会报错。因此，在某些程序中，为了避【版权所有，侵权必究】【原创内容，转载请注明出处】免这种情况的发生，我们使用put方法。

更新数据

let transaction = db.transaction(['myObjectStore'], 'readonly')
let objectStore = transaction.objectStore('myObjectStore')
let request = objectStore.put({
 id: '100002',
 name: 'Zhang Fei',
})

put方法和add方法有两大区别。一，如未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。果objectStore中已经有了该id转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】，则表示更新这个object，如果没有，【版权所有，侵权必究】原创内容，盗版必究。则添加这个object。二，在另一种情况转载请注明出处：www.tangshuang.net原创内容，盗版必究。下，也就是设置了autoIncremen【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。t为true的时候，也就是主键自增的时候【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net，put方法必须传第二个参数，第二个参数【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】是主键的值，以此来确定你要更新的是哪一个本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】主键对应的object，如果不传的话，可著作权归作者所有，禁止商业用途转载。【本文受版权保护】能会直接增加一个object到数据库中。未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。从这一点上讲，自增字段确实比较难把握，因【原创内容，转载请注明出处】【作者：唐霜】此我建议开发者严格自己在传入时保证obj【本文受版权保护】【未经授权禁止转载】ect中存在主键值。

删除数据

let transaction = db.transaction(['myObjectStore'], 'readonly')
let objectStore = transaction.objectStore('myObjectStore')
let request = objectStore.delete('100001')

delete方法把你传入的主键值对应的o本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。bject从数据库中删除。

IndexedDB API

本节主要把indexedDB中最常用的所本文作者：唐霜，转载请注明出处。【未经授权禁止转载】有api进行列举，起到快速查阅的作用。注【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net意，这里仅是最常用，基本可以覆盖90%的【原创不易，请尊重版权】未经授权，禁止复制转载。使用场景，但并不代表所有的api都在这里【转载请注明来源】【版权所有】唐霜 www.tangshuang.net，你可以通过这里查阅全部。

IDBDatabase

【原创内容，转载请注明出处】【本文首发于唐霜的博客】未经授权，禁止复制转载。

let request = indexedDB.open(name, version)
request.onsuccess = (e) => {
  let db = e.target.result // 获得db
}

name

通过idb.name获取当前连接到的数据未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。库的名字。这和你在open的时候传入的n【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。ame是一致的。

version

原创内容，盗版必究。【关注微信公众号：wwwtangshua【作者：唐霜】【作者：唐霜】ngnet】【转载请注明来源】著作权归作者所有，禁止商业用途转载。

objectStoreNames

获取当前数据库的所有objectStor【未经授权禁止转载】未经授权，禁止复制转载。e的name列表，是一个数组。

createObjectStore()

创建一个objectStore，有两个参【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】数：

name：要创建的objectStore【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】的name

【本文首发于唐霜的博客】

【原创内容，转载请注明出处】

转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。ng.net

著作权归作者所有，禁止商业用途转载。

options：选项
- keyPath：主键，你将要存入的obj【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】ect的一个property name，本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】比如每一个object都有一个id属性，【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net那么可以使用id作为keyPath，在查【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。询的时候，get方法的参数，是id值
- autoIncrement：keyPat【本文首发于唐霜的博客】【转载请注明来源】h是否自增，如果为true，那么你在添加【作者：唐霜】【本文首发于唐霜的博客】一个object的时候，可以不用传id，【未经授权禁止转载】原创内容，盗版必究。id会自动加1。但是这样的话，你就不知道【本文首发于唐霜的博客】【转载请注明来源】你的这个object的id值到底是多少，本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】所以不建议使用。默认为false

本文版权归作者所有，未经授权不得转载。

例子：

【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。

db.createObjectStore('students', { keyPaht: 'id', autoIncrement: false })

deleteObjectStore()

删除一个objectStore，参数只有转载请注明出处：www.tangshuang.net【作者：唐霜】一个：

name：要删除的objectStore【转载请注明来源】著作权归作者所有，禁止商业用途转载。的name

【原创不易，请尊重版权】

【作者：唐霜】

删除的时候，它的所有index也被删除了【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】。

【访问 www.tangshuang.n转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】【转载请注明来源】

close()

【关注微信公众号：wwwtangshua【转载请注明来源】【作者：唐霜】ngnet】著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】ng.net

transaction()

重头戏，开启一个事务，是后续操作的开始。转载请注明出处：www.tangshuang.net【版权所有，侵权必究】前文已经讲过了，任何操作都是要在事务中进【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net行的，对于一个database而言，如果【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net要获取里面的数据，或者修改其中的某一个o未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.netbjectStore，都要通过这个方法来【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。开启一个事务，在事务中进行操作。

转载请注明出处：www.tangshua原创内容，盗版必究。【转载请注明来源】ng.net未经授权，禁止复制转载。

它有两个参数：

objectStoreNames：一个数【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】组，表示你开启的这个事务，要准备对哪些o转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。bjectStore进行操作，在这个事务【原创内容，转载请注明出处】【本文受版权保护】中，只有这些objectStore能被选原创内容，盗版必究。本文作者：唐霜，转载请注明出处。中，如果你选中其他的objectStor【原创不易，请尊重版权】【作者：唐霜】e，会报错。

【转载请注明来源】

【原创内容，转载请注明出处】

mode：读写权限，主要可用的值：rea转载请注明出处：www.tangshuang.net【版权所有，侵权必究】donly, readwrite

【作者：唐霜】

【原创不易，请尊重版权】

转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。ng.net

原创内容，盗版必究。

我们用代码来看下用法：

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。

let tx = idb.transaction(['students'], 'readonly')

这样就获得了一个database的事务容原创内容，盗版必究。【原创不易，请尊重版权】器。

未经授权，禁止复制转载。【本文首发于唐霜的博客】

【原创不易，请尊重版权】【作者：唐霜】

IDBTransaction

关于transaction的概念前面已经【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net说了，这里主要看下，得到一个transa转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。ction之后可以干什么。

转载请注明出处：www.tangshua著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。ng.net【关注微信公众号：wwwtangshua【本文受版权保护】本文作者：唐霜，转载请注明出处。ngnet】

db

获取这个transaction是对哪个d【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】atabase进行操作的事务。

objectStoreNames

mode

读写权限，和你传入的mode一致。

abort()

终止该事务，一旦人为终止，你程序中的某些【关注微信公众号：wwwtangshuangnet】【转载请注明来源】操作就不会再执行了。

objectStore()

获取事务中的某个objectStore的【本文首发于唐霜的博客】原创内容，盗版必究。容器。它有一个参数：

【作者：唐霜】【本文首发于唐霜的博客】【转载请注明来源】

name：objectStore的nam未经授权，禁止复制转载。原创内容，盗版必究。e

转载请注明出处：www.tangshua【本文受版权保护】未经授权，禁止复制转载。ng.net

转载请注明出处：www.tangshua原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。ng.net

获得该objectStore容器之后，就未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。可以利用它进行objectStore的数转载请注明出处：www.tangshuang.net【本文受版权保护】据增删改查了。

【本文首发于唐霜的博客】【本文首发于唐霜的博客】

let tx = idb.transaction(['students'], 'readonly')
let objStore = tx.objectStore('students')

// 利用objStore进行查询：
let request = objStore.get('100001')

【未经授权禁止转载】【转载请注明来源】

IDBObjectStore

重头戏，objectStore是最核心的【作者：唐霜】【原创不易，请尊重版权】概念了，它的容器，也就是上面这段代码中的objStore，都可以进行哪些后续操作呢？

转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】ng.net著作权归作者所有，禁止商业用途转载。【转载请注明来源】

name

keyPath

和创建的时候传入的keyPath一致。

autoIncrement

和创建的时候传入的autoIncreme著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。nt一致。

原创内容，盗版必究。【未经授权禁止转载】

indexNames

未经授权，禁止复制转载。【访问 www.tangshuang.n【本文首发于唐霜的博客】未经授权，禁止复制转载。et 获取更多精彩内容】

transaction

获取该objectStore所属的tra【原创内容，转载请注明出处】原创内容，盗版必究。nsaction的容器。一个object【作者：唐霜】【版权所有，侵权必究】Store的容器，只有在事务中才能得到，【转载请注明来源】本文版权归作者所有，未经授权不得转载。因此这个objectStore的容器一定原创内容，盗版必究。转载请注明出处：www.tangshuang.net属于某个事务，那么也就有对应的trans未经授权，禁止复制转载。【未经授权禁止转载】action容器。通过transacti本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】on容器，其实可以做很多操作，比如获取和未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】该objectStore一起操作的其他o原创内容，盗版必究。原创内容，盗版必究。bjectStore的name。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。

get()

发起一个获取object的Request原创内容，盗版必究。【转载请注明来源】。Request我们还没有讲到，后面会讲【转载请注明来源】转载请注明出处：www.tangshuang.net。它有一个参数：

key：主键的值，比如你要获取一个id=【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。100001的object，那么key应【版权所有】唐霜 www.tangshuang.net【转载请注明来源】该传入100001

本文版权归作者所有，未经授权不得转载。

【转载请注明来源】

代码说话：

【转载请注明来源】【原创不易，请尊重版权】原创内容，盗版必究。

let objStore = tx.objectStore('students')
let request = objStore.get(100001)

而要得到最后查询到的object，需要在【本文受版权保护】转载请注明出处：www.tangshuang.netrequest的onsuccess中获取未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】。所以后面讲完Request之后，你就能【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】正确使用代码了。

【原创内容，转载请注明出处】原创内容，盗版必究。转载请注明出处：www.tangshua【未经授权禁止转载】【转载请注明来源】ng.net

add()

发起一个添加object的Request【作者：唐霜】原创内容，盗版必究。。它有一个参数：

object：要添加的object，ob转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】ject应该包含主键，这取决于autoI【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。ncrement是否为true

原创内容，盗版必究。

还是用代码来看下：

let objStore = tx.objectStore('students')
let request = objStore.add({
  id: '100002',
  name: 'Li Hua',
})

delete()

发起一个删除object的Request本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。。它有一个参数：

key: 主键值，和get一样。

【访问 www.tangshuang.n本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】

put()

发起一个更新某个object的Reque本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。st。它有两个参数：

【原创内容，转载请注明出处】【作者：唐霜】本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。

object：要更新的object

原创内容，盗版必究。

key：要更新的object的主键值

本文作者：唐霜，转载请注明出处。

【原创内容，转载请注明出处】

关于key非常难理解。当你在创建一个ob原创内容，盗版必究。【转载请注明来源】jectStore的时候，你可能会传入a本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。utoIncrement为true，这时【作者：唐霜】未经授权，禁止复制转载。，这个objectStore和我们经常使本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。用的有点不同。比如你的主键是id，那么如【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。果你在add或put的时候，不传这个id【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net，id值会自动加1，你get到的obje本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】ct也会包含id属性。

当你在使用put方法去更新的时候，如果你著作权归作者所有，禁止商业用途转载。【转载请注明来源】的objectStore的autoInc本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】rement是true，就必须传入第二个未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net参数key，put方法会先通过key找到本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】该object，然后在用object的内【未经授权禁止转载】原创内容，盗版必究。容去更新。而如果不传key，那么你传入的【转载请注明来源】【本文受版权保护】第一个参数object中必须包含id，否【转载请注明来源】原创内容，盗版必究。则会报错。
转载请注明出处：www.tangshua【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。ng.net 但是如果你的autoIncrement【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。设置的是false，那就可以考虑忽略ke原创内容，盗版必究。【原创内容，转载请注明出处】y。但是效果还是不一样，当你传入key值未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。的时候，会更新传入的key对应的那个ob未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。ject。不传的时候，根据你object转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net里面的主键来更新，没有的话会被认为是ad【作者：唐霜】转载请注明出处：www.tangshuang.netd操作，不会报错。

未经授权，禁止复制转载。【版权所有】唐霜 www.tangshu【版权所有】唐霜 www.tangshuang.net【版权所有】唐霜 www.tangshuang.netang.net【版权所有】唐霜 www.tangshu转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netang.net【版权所有】唐霜 www.tangshu本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。ang.net

所以比较好的一种操作是，不设置autoI未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。ncrement，无论是添加还是修改ob本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】ject，都使用put，只要开发者自己注【未经授权禁止转载】【原创内容，转载请注明出处】意，传入的object一定要有一个主键即原创内容，盗版必究。【本文受版权保护】可。这样当存在该主键值时，就更新，不存在【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】时就插入。这比使用add好很多，因为ad【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】d的时候，如果存在会报错。

本文版权归作者所有，未经授权不得转载。【转载请注明来源】

如果你还有不理解的地方，欢迎在下方留言，未经授权，禁止复制转载。【原创内容，转载请注明出处】对这个问题进行探讨。

count()

【转载请注明来源】【作者：唐霜】【转载请注明来源】本文版权归作者所有，未经授权不得转载。

clear()

没有参数，发起一个删除objectSto【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。re里面的所有object的Reques原创内容，盗版必究。【转载请注明来源】t。

原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。【作者：唐霜】

清除数据之前请备份好数据。

【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】转载请注明出处：www.tangshua【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。ng.net

openCursor()

发起一个打开游标的Request。它的参未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。数统一在IDBCursor中讲。

未经授权，禁止复制转载。原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

index()

通过index方法，可以建立一个类似SQ转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netL数据库中视图。它先得到一个IDBInd【未经授权禁止转载】【本文受版权保护】ex，然后你在对这个IDBIndex进行【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。操作。因此它不是发起一个Request，【本文受版权保护】转载请注明出处：www.tangshuang.net这有别于前面的方法。返回的IDBInde【本文首发于唐霜的博客】【版权所有，侵权必究】x会在下文详细描述它的API。index【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。方法由一个参数：

indexName：要用来作为索引视图的【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。索引名称

未经授权，禁止复制转载。

【未经授权禁止转载】

【转载请注明来源】

看下代码怎么用：

let objStore = tx.objectStore('students')
let objIndex = objStore.index('name')
let request = objIndex.get('Li Hua')

createIndex()

创建一个索引，和前面的方法不同，它不是发原创内容，盗版必究。未经授权，禁止复制转载。起一个Request，而是直接进行操作，【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。并且返回一个IDBIndex。关于IDB【原创内容，转载请注明出处】【本文首发于唐霜的博客】Index，我会在Request后面再讲【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。。它有三个参数：

indexName：索引的名字，自己规定原创内容，盗版必究。未经授权，禁止复制转载。的，后面作为根据索引进行查询的依据

【本文受版权保护】

【原创不易，请尊重版权】

未经授权，禁止复制转载。

keyPath：该索引对应object中【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】的那个属性名，最好indexName和k【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】eyPath相等，这样便于记忆

【转载请注明来源】

【未经授权禁止转载】

【转载请注明来源】

【原创不易，请尊重版权】

【原创内容，转载请注明出处】

虽然objectParameters还有【转载请注明来源】原创内容，盗版必究。其他选项，但是常用的就是unique。

注意，只能在onupgradeneede【本文受版权保护】本文作者：唐霜，转载请注明出处。d中使用。

deleteIndex()

【本文受版权保护】【原创内容，转载请注明出处】【本文首发于唐霜的博客】

name：要删除的索引的name，和cr原创内容，盗版必究。【本文首发于唐霜的博客】eateIndex的时候传入的index本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。Name一致。

【转载请注明来源】

本文版权归作者所有，未经授权不得转载。

删除索引之后，就不能再根据索引查询数据了本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】。

【转载请注明来源】转载请注明出处：www.tangshua未经授权，禁止复制转载。原创内容，盗版必究。ng.net转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。ng.net本文作者：唐霜，转载请注明出处。

IDBRequest

前面一直强调事务的概念，没有对Reque【未经授权禁止转载】原创内容，盗版必究。st进行介绍。Request是在事务过程【原创不易，请尊重版权】【作者：唐霜】中，发起某项操作的请求。一个事务过程中，【本文受版权保护】【转载请注明来源】可以有多个Request，Request【未经授权禁止转载】本文作者：唐霜，转载请注明出处。一定存在与事务中，因此它肯定会有一个tr原创内容，盗版必究。【原创内容，转载请注明出处】ansaction属性来获取它所属于的那【本文受版权保护】原创内容，盗版必究。个事务的容器。

原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。

目前，在indexedDB中，有四种可能【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。产生Request：open datab【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】ase，objectStore requ【作者：唐霜】著作权归作者所有，禁止商业用途转载。est, cursor request,【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。 index request。

readyState

Request的状态。只有两种状态：pe【未经授权禁止转载】【未经授权禁止转载】nding, done。

【作者：唐霜】【关注微信公众号：wwwtangshua本文作者：唐霜，转载请注明出处。原创内容，盗版必究。ngnet】

transaction

【关注微信公众号：wwwtangshua著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】ngnet】著作权归作者所有，禁止商业用途转载。

source

获取该Request是由谁发起的，它可能【转载请注明来源】【版权所有，侵权必究】有四种情况：objStore, curs【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netor, index, null. 当该R著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】equest是open database【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】的时候发起，source值为null。

原创内容，盗版必究。【原创不易，请尊重版权】【本文受版权保护】本文作者：唐霜，转载请注明出处。

通过该source值，其实可以获取更多信转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】息，比如objectStore的其他信息原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。。

本文版权归作者所有，未经授权不得转载。【转载请注明来源】【未经授权禁止转载】

result

获取该Request的输出结果。该值最开【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。始是undefined，只有当Reque著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】st成功之后，该值才会出现。因此，要获取未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net一个get的最终结果，必须在Reques【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.nett的onsuccess事件中调用：

【关注微信公众号：wwwtangshua【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。ngnet】本文作者：唐霜，转载请注明出处。

let request = objectStore.get(10001)
request.onsuccess = e => {
  let item = request.result
  // 等价于
  let item = e.tareget.result
}

IDBIndex

索引的概念就不讲了，这里主要是把最常用的【本文受版权保护】未经授权，禁止复制转载。有关所有的api列举出来，方便使用。

什么情况下会产生IDBIndex呢？当调【原创内容，转载请注明出处】【未经授权禁止转载】用一个objectStore的index【作者：唐霜】著作权归作者所有，禁止商业用途转载。方法时，前文在讲IDBObjectSto本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】re的时候已经讲到过了。

未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。

let objStore = tx.objectStore('students')
let objIndex = objStore.index('name')

通过index方法之后，这个objInd【本文受版权保护】著作权归作者所有，禁止商业用途转载。ex可以进行哪些操作呢？

name

该属性可以获取index的name。

【转载请注明来源】【访问 www.tangshuang.n转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】【原创不易，请尊重版权】【未经授权禁止转载】

keyPath

unique

返回是否是唯一的，和你createInd【作者：唐霜】著作权归作者所有，禁止商业用途转载。ex的时候传入的值是一致的。

【本文受版权保护】【本文受版权保护】【未经授权禁止转载】

isAutoLocale

locale

如果这个index对应的字段是自增的，那本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】么现在的自增基础值是多少？比如你的id是【作者：唐霜】原创内容，盗版必究。自增的，现在objectStore里面有【原创不易，请尊重版权】【本文首发于唐霜的博客】10个object，这时objIndex【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】.locale应该是10.

原创内容，盗版必究。转载请注明出处：www.tangshua著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。ng.net【访问 www.tangshuang.n【转载请注明来源】【原创不易，请尊重版权】et 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。

objectStore

因为IDBIndex总是通过object【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.netStore的index方法产生的，所以它【转载请注明来源】著作权归作者所有，禁止商业用途转载。自然会有对应的那个objectStore【未经授权禁止转载】原创内容，盗版必究。，而自己的objectStore属性正好【版权所有，侵权必究】原创内容，盗版必究。是一个引用，指向那个产生自己的objec本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。tStore。

count()

发起一个当前index视图总共有多少个o著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。bject的Request。

【未经授权禁止转载】【未经授权禁止转载】【未经授权禁止转载】【本文首发于唐霜的博客】

get()

著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。

key: 这个key其实是指你的inde【本文受版权保护】原创内容，盗版必究。x的keyPath的值

【原创内容，转载请注明出处】

【访问 www.tangshuang.n【未经授权禁止转载】【原创内容，转载请注明出处】et 获取更多精彩内容】

【原创不易，请尊重版权】

【作者：唐霜】转载请注明出处：www.tangshua【本文受版权保护】本文作者：唐霜，转载请注明出处。ng.net未经授权，禁止复制转载。【原创内容，转载请注明出处】

{
  id: 1,
  name: 'tom',
}

let request = objIndex.get('tom') // 这个tom是name属性的值

openCursor()

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshua著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。ng.net本文版权归作者所有，未经授权不得转载。

可以看出，objIndex对于objSt未经授权，禁止复制转载。未经授权，禁止复制转载。ore而言，方法少了很多，它不能更新、删【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】除等。但是实际上，通过objectSto【原创不易，请尊重版权】【作者：唐霜】re属性，就可以反过来对objectSt【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】ore进行操作。

本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。

IDBCursor

原创内容，盗版必究。【作者：唐霜】【原创内容，转载请注明出处】【转载请注明来源】

【原创内容，转载请注明出处】原创内容，盗版必究。【访问 www.tangshuang.n【作者：唐霜】本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】

openCursor()

objectStore或objectIn本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】dex可以使用这个方法打开一个游标的Re【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】quest。它有两个参数：

【未经授权禁止转载】【本文首发于唐霜的博客】

range：游标的值域，也就是说，游标在【作者：唐霜】转载请注明出处：www.tangshuang.net遍历过程中，仅对值域范围内的那些obje转载请注明出处：www.tangshuang.net【转载请注明来源】ct进行遍历

未经授权，禁止复制转载。

【访问 www.tangshuang.n著作权归作者所有，禁止商业用途转载。【转载请注明来源】et 获取更多精彩内容】

direction：遍历的方向，有如下选转载请注明出处：www.tangshuang.net【作者：唐霜】择：next，nextunique，pr原创内容，盗版必究。【本文受版权保护】ev，prevunique。看名字应该就【转载请注明来源】本文作者：唐霜，转载请注明出处。可以理解了。

著作权归作者所有，禁止商业用途转载。

原创内容，盗版必究。

未经授权，禁止复制转载。

打开游标后，游标怎么获得呢？在Reque【原创内容，转载请注明出处】【原创内容，转载请注明出处】st的onsuccess中得到的：

【未经授权禁止转载】转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】【转载请注明来源】ng.net

objStore.openCursor().onsuccess = e => {
  let cursor = e.target.result // 这个才是我们要的游标
}

接下来就是看看，这个cursor有哪些接【本文首发于唐霜的博客】【作者：唐霜】口。

本文版权归作者所有，未经授权不得转载。【本文受版权保护】转载请注明出处：www.tangshua【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。ng.net

direction

游标遍历的方向，方向前面说过了，和你op【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】enCursor的时候传入的是一致的。

key

【本文首发于唐霜的博客】转载请注明出处：www.tangshua【本文受版权保护】未经授权，禁止复制转载。ng.net【未经授权禁止转载】

{
  id: 2,
  name: 'sue',
}

而你开启这个游标，又是通过objStore.index('name').openCursor()开启的，那么这个时候这个key值，就是s【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】ue了。

【关注微信公众号：wwwtangshua【作者：唐霜】【关注微信公众号：wwwtangshuangnet】ngnet】未经授权，禁止复制转载。【转载请注明来源】【未经授权禁止转载】

primaryKey

游标遍历所在位置的object的主键。这原创内容，盗版必究。【转载请注明来源】个比较难理解，key和primaryKe【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。y的区别主要体现在你用索引进行检索的时候【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】，如果你openCursor是在非索引集【原创不易，请尊重版权】【未经授权禁止转载】合情况下，其实key和primaryKe【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。y是一样的，因为都是以主键作为索引。但是【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。当你用index方法筛选出子集，那么这个【原创内容，转载请注明出处】原创内容，盗版必究。时候primaryKey在某些情况下就非著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。常有必要知道。

转载请注明出处：www.tangshua【转载请注明来源】转载请注明出处：www.tangshuang.netng.net【作者：唐霜】本文作者：唐霜，转载请注明出处。

source

该属性返回开启游标的容器的引用，也就是o本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。bjStore或objIndex。

value

continue()

【原创内容，转载请注明出处】【作者：唐霜】【原创不易，请尊重版权】

【本文受版权保护】

未经授权，禁止复制转载。

【转载请注明来源】

转载请注明出处：www.tangshua【未经授权禁止转载】【本文受版权保护】ng.net

advance()

【访问 www.tangshuang.n【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】【版权所有】唐霜 www.tangshu【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】ang.net原创内容，盗版必究。【访问 www.tangshuang.n本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】et 获取更多精彩内容】

count：你规定的往前移动的格数。

著作权归作者所有，禁止商业用途转载。

【作者：唐霜】

continuePrimaryKey()

前面讲了primaryKey这个属性，也著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。讲了continue(key)这个方法的转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】参数key。但是，当你在openCurs【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】or的时候，索引的值可重复时，那就会出现【未经授权禁止转载】原创内容，盗版必究。尴尬的情况。在objectStore里面本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】存储数据的时候，primaryKey和其【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】他索引的key，它们的值可能是重复的，但【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。是如果通过两个key的值来确定呢？那么就【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。能更准确的定位某一个object。因此，【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。当你使用continuPrimaryKe转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。y的时候，是为了解决这个问题，即cont【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】inue()只会根据参数，往下移动到下一【关注微信公众号：wwwtangshuangnet】【作者：唐霜】个给定参数值的object，而如果使用c【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】ontinuePrimaryKey()，【关注微信公众号：wwwtangshuangnet】【本文受版权保护】那么在往下一个给定值移动时，还会再考虑p【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】rimaryKey的值。

一般来说primaryKey的值都是唯一原创内容，盗版必究。【本文受版权保护】的，但也不排除有些情况不唯一的时候，这个【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】时候，使用游标结合continuePri【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】maryKey才能正确获得你想要的那个o【转载请注明来源】本文作者：唐霜，转载请注明出处。bject，通过普通的get只能得到第一本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net个object。

delete()

发起一个删除当前游标所在的object的转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.netRequest。删除之后，就要考虑用co未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】ntinuePrimaryKey()，而【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】不是continue()。

本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua未经授权，禁止复制转载。【本文首发于唐霜的博客】ng.net转载请注明出处：www.tangshua【转载请注明来源】【转载请注明来源】ng.net【访问 www.tangshuang.n【本文首发于唐霜的博客】【转载请注明来源】et 获取更多精彩内容】

update()

发起一个更新当前游标所在的这个objec本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】t的对应字段的值的Request。它有一【本文受版权保护】原创内容，盗版必究。个参数：

【访问 www.tangshuang.n【本文受版权保护】【本文首发于唐霜的博客】et 获取更多精彩内容】本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。ng.net

【原创内容，转载请注明出处】

著作权归作者所有，禁止商业用途转载。

本文版权归作者所有，未经授权不得转载。

小结

本文所有的内容就讲完了，本文从 Inde【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。xedDB 的概念和结构开始，把所有常用【原创不易，请尊重版权】【转载请注明来源】的 API 都讲了一遍，并且还给出了很多未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。例子。
【原创内容，转载请注明出处】有人做过一个预测，Web SQL 数据【本文受版权保护】【作者：唐霜】库已经从标准中移除了，有可能在后面的浏览转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。器版本中被去除，IndexedDB 将有【版权所有】唐霜 www.tangshuang.net【版权所有，侵权必究】可能统一浏览器本地化存储的数据库。

虽然本文对大部分 IndexedDB 的【未经授权禁止转载】【原创内容，转载请注明出处】接口都进行了讲解，但是还只是入门教程，还【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。有很多东西没讲。举个例子，作为数据库，最【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。重要的就是检索功能，也就是索引检索的那个【本文首发于唐霜的博客】【本文受版权保护】部分，但是本文并没有对这个部分展开。索引【本文首发于唐霜的博客】原创内容，盗版必究。检索还可以实现阈值检索，比如检索某一段日【作者：唐霜】【版权所有，侵权必究】期内的所有 object，比如检索所有同【原创不易，请尊重版权】未经授权，禁止复制转载。姓氏的同学，这些问题都是经常遇到的，但都【作者：唐霜】著作权归作者所有，禁止商业用途转载。不再本文的讲解范围内。想要完全了解 in本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。dexedDB，还需要你继续深入学习。

参考文献

HTML5 indexedDB前端本地存【原创不易，请尊重版权】【作者：唐霜】储数据库实例教程

【原创内容，转载请注明出处】

著作权归作者所有，禁止商业用途转载。

【本文首发于唐霜的博客】

indb 可能是最便捷的 indexedDB 操【转载请注明来源】本文版权归作者所有，未经授权不得转载。作库

【原创不易，请尊重版权】

原创内容，盗版必究。

【本文受版权保护】

【未经授权禁止转载】

著作权归作者所有，禁止商业用途转载。

【原创内容，转载请注明出处】

【未经授权禁止转载】

【版权所有】唐霜 www.tangshuang.net【本文受版权保护】本文作者：唐霜，转载请注明出处。【未经授权禁止转载】【转载请注明来源】【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】【原创内容，转载请注明出处】原创内容，盗版必究。【原创不易，请尊重版权】【转载请注明来源】【原创不易，请尊重版权】【原创内容，转载请注明出处】【版权所有，侵权必究】未经授权，禁止复制转载。【转载请注明来源】【关注微信公众号：wwwtangshuangnet】【转载请注明来源】【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【转载请注明来源】【未经授权禁止转载】

如果你觉得本书对你有帮助，通过下方的二维码向我打赏吧，帮助我写出更多有用的内容。

2017-09-09 | indexedDB

已有11条评论

Feng 2024-09-23 11:13

文章中的部分图片失效了

回复
- 否子戈 2024-10-05 22:50
  
  CDN域名证书过期了，已经修复
  
  回复
Liang 2023-04-01 08:14

最近在做ChatGPT相关的一个项目，想在浏览器本地保存聊天记录，才知道了有内置 indexedDB 这个数据库，在尝试之后发现好难用！

在网上搜索到了 Dexie.js 封装了相关的 API，找中文教程时顺藤摸瓜找到了博主的文章，非常感谢您，写得很详细，很多我不理解东西都被讲明白了，今晚尝试一下！

回复
傅莺仟 2022-12-29 13:51

我想请教一个问题，indexdb上存储的数据怎么可以转移到另外一个pc端（假设数据量比较大，除了通过将数据全部查询出来，然后再一条一条导入新的的pc端，还有什么好的办法吗？）

回复
- 否子戈 2023-01-03 11:16
  
  indexeddb属于本地持久化存储，它设计的目标就是本地存储，不是共享，如果你是要共享数据，应该是搭数据服务，如果只是为了做数据迁移，目前没有更好的办法，自己写个程序把库导出为一个json，再发送给另外一个用户写个导入程序
  
  回复
Coolkk 2020-02-22 00:27

感谢教程。

回复
老李 2019-12-02 10:05

感謝大大分享
非常實用且完整
解釋淺顯易懂
讓在網路上自學的我收穫匪淺

回复
ospider 2018-02-28 01:40

关于版本那一块，好像文中也没有详细解释了，如果有时间，还请写一下呀

> 这时你会想，如果我从新的version切换为老的version，还可以在老的version里面添加数据吗？这个问题我们暂时保留。

回复
- 否子戈 2018-02-28 14:11
  
  在文章中添加来补充内容，关于降级我没有实际测试过，如果你有兴趣对话，可以试一下。
  
  回复
ospider 2018-02-26 18:59

代码都被压成一行了。。大佬有时间改下么

回复
- 否子戈 2018-02-28 13:09
  
  谢谢提醒
  
  回复