IDBVersionChangeEvent
注意:此功能在Web Workers中可用。
IDBVersionChangeEvent
是 IndexedDB API 的一个接口,它指示数据库的版本已更改,这是 onupgradeneeded
事件处理程序函数的结果。
构造函数
IDBVersionChangeEvent()
-
创建并返回一个新的
IDBVersionChangeEvent
对象,用于表示数据库版本何时发生更改。
实例属性
还继承了其父级 Event
接口的属性。
IDBVersionChangeEvent.oldVersion
只读-
返回数据库的旧版本。
IDBVersionChangeEvent.newVersion
只读-
返回数据库的新版本。
实例方法
没有特定方法,但继承了其父级 Event
接口的方法。
示例
在下面的代码片段中,我们发出打开数据库的请求,并包含成功和错误情况的处理程序。在版本更改(upgradeneeded
事件之后)时,success
事件将实现 IDBVersionChangeEvent
接口。有关完整的示例,请参阅我们的 待办事项通知 应用(查看示例)。
js
const note = document.querySelector("ul");
// Let us open version 4 of our database
const DBOpenRequest = window.indexedDB.open("toDoList", 4);
// these two event handlers act on the database being opened successfully, or not
DBOpenRequest.onerror = (event) => {
note.appendChild(document.createElement("li")).textContent =
"Error loading database.";
};
DBOpenRequest.onsuccess = (event) => {
note.appendChild(document.createElement("li")).textContent =
"Database initialized.";
// store the result of opening the database in the db variable. This is used a lot later on, for opening transactions and suchlike.
const db = DBOpenRequest.result;
};
规范
规范 |
---|
Indexed Database API 3.0 # 事件 |
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。
另请参阅
- 使用 IndexedDB
- 启动事务:
IDBDatabase
- 使用事务:
IDBTransaction
- 设置键范围:
IDBKeyRange
- 检索和更改数据:
IDBObjectStore
- 使用游标:
IDBCursor
- 参考示例:待办事项通知(查看示例)。