IDBVersionChangeEvent

注意:此功能在Web Workers中可用。

IDBVersionChangeEventIndexedDB API 的一个接口,它指示数据库的版本已更改,这是 onupgradeneeded 事件处理程序函数的结果。

Event IDBVersionChangeEvent

构造函数

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 的浏览器中加载。

另请参阅