IDBVersionChangeEvent
注意:此功能在 Web Workers 中可用。
IDBVersionChangeEvent 接口是 IndexedDB API 的一部分,表示数据库的版本已更改,这是由 onupgradeneeded 事件处理函数触发的。
构造函数
IDBVersionChangeEvent()-
创建一个并返回一个新的
IDBVersionChangeEvent对象,用于表示数据库版本已更改。
实例属性
也继承自其父接口 Event 的属性。
IDBVersionChangeEvent.oldVersion只读-
返回数据库的旧版本。
IDBVersionChangeEvent.newVersion只读-
返回数据库的新版本。
实例方法
没有特定方法,但继承了其父接口 Event 的方法。
示例
在以下代码片段中,我们发出一个打开数据库的请求,并包含成功和错误情况的处理程序。在版本更改后(在 upgradeneeded 事件之后),success 事件将实现 IDBVersionChangeEvent 接口。完整的可运行示例,请参阅我们的 To-do Notifications 应用(在线查看示例)。
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 # events |
浏览器兼容性
加载中…
另见
- 使用 IndexedDB
- 开始事务:
IDBDatabase - 使用事务:
IDBTransaction - 设置键的范围:
IDBKeyRange - 检索和修改数据:
IDBObjectStore - 使用游标:
IDBCursor - 参考示例:待办事项通知(查看实时示例)。