IndexedDB 中 upgradeneeded 和 blocked 事件的触发场景剖析

2023-10-23 01:08:36

IndexedDB 是一个低级的 API，提供了在浏览器中存储数据的强大功能。它允许开发者在浏览器中持久化数据，即使在浏览器关闭或计算机重新启动后，这些数据仍然存在。IndexedDB 还提供了对数据的索引和查询功能，这使得它非常适合存储大型数据集。

在 IndexedDB 中，有 upgradeneeded 和 blocked 两个事件。这两个事件在数据库升级和数据迁移时都会被触发。

upgradeneeded 事件

upgradeneeded 事件在打开数据库时触发，当数据库版本发生变化时，也会触发此事件。在处理 upgradeneeded 事件时，开发者可以执行一些任务，例如：

创建或删除对象存储空间。
创建或删除索引。
修改数据结构。

upgradeneeded 事件的处理程序是一个函数，它接收一个参数，即 Event 对象。Event 对象包含有关事件的信息，例如：

oldVersion：数据库的旧版本。
newVersion：数据库的新版本。

在处理 upgradeneeded 事件时，开发者可以使用 IDBDatabase 接口的 createObjectStore() 和 deleteObjectStore() 方法来创建或删除对象存储空间。他们还可以使用 IDBDatabase 接口的 createIndex() 和 deleteIndex() 方法来创建或删除索引。

blocked 事件

blocked 事件在数据库事务执行期间触发，当事务中的某个操作被阻止时，就会触发此事件。在处理 blocked 事件时，开发者可以执行一些任务，例如：

重试事务。
中止事务。

blocked 事件的处理程序是一个函数，它接收一个参数，即 Event 对象。Event 对象包含有关事件的信息，例如：

transaction：引发 blocked 事件的事务。
request：被阻止的请求。

在处理 blocked 事件时，开发者可以使用 IDBTransaction 接口的 abort() 方法来中止事务。他们还可以使用 IDBRequest 接口的 retry() 方法来重试事务。

触发场景分析

upgradeneeded 事件和 blocked 事件都是在 IndexedDB 中非常重要的事件。它们允许开发者在数据库升级和数据迁移时执行一些任务，以确保数据库的正确性和完整性。

以下是对 upgradeneeded 事件和 blocked 事件触发场景的详细分析：

upgradeneeded 事件：
- 当打开数据库时，数据库版本发生变化时，就会触发此事件。
- 当使用 IDBDatabase 接口的 createObjectStore() 方法创建对象存储空间时，就会触发此事件。
- 当使用 IDBDatabase 接口的 deleteObjectStore() 方法删除对象存储空间时，就会触发此事件。
- 当使用 IDBDatabase 接口的 createIndex() 方法创建索引时，就会触发此事件。
- 当使用 IDBDatabase 接口的 deleteIndex() 方法删除索引时，就会触发此事件。
blocked 事件：
- 当数据库事务执行期间，某个操作被阻止时，就会触发此事件。
- 当使用 IDBObjectStore 接口的 add() 方法添加数据时，数据大小超过了对象存储空间的限制时，就会触发此事件。
- 当使用 IDBObjectStore 接口的 put() 方法修改数据时，数据大小超过了对象存储空间的限制时，就会触发此事件。
- 当使用 IDBObjectStore 接口的 delete() 方法删除数据时，数据不存在时，就会触发此事件。
- 当使用 IDBCursor 接口的 next() 方法获取下一个数据时，没有更多数据时，就会触发此事件。
- 当使用 IDBCursor 接口的 prev() 方法获取上一个数据时，没有更多数据时，就会触发此事件。