IDBOpenDBRequest: upgradeneeded 事件

当尝试打开的数据库版本号高于当前版本时，会触发 upgradeneeded 事件。

此事件不可取消，也不冒泡。

语法

在诸如 addEventListener() 之类的方法中使用事件名称，或者设置事件处理程序属性。

addEventListener("upgradeneeded", (event) => {});

onupgradeneeded = (event) => {};

事件类型

一个 IDBVersionChangeEvent。继承自 Event。

事件属性

也继承了其父级 Event 接口的属性。

IDBVersionChangeEvent.oldVersion 只读: 返回数据库的旧版本。
IDBVersionChangeEvent.newVersion 只读: 返回数据库的新版本。

示例

此示例打开一个数据库，并通过对对象存储进行必要的更新来处理 upgradeneeded 事件。

// Open the database
const dBOpenRequest = window.indexedDB.open("toDoList", 4);

dBOpenRequest.addEventListener("upgradeneeded", (event) => {
  const db = event.target.result;
  console.log(`Upgrading to version ${db.version}`);

  // Create an objectStore for this database
  const objectStore = db.createObjectStore("toDoList", {
    keyPath: "taskTitle",
  });

  // define what data items the objectStore will contain
  objectStore.createIndex("hours", "hours", { unique: false });
  objectStore.createIndex("minutes", "minutes", { unique: false });
  objectStore.createIndex("day", "day", { unique: false });
  objectStore.createIndex("month", "month", { unique: false });
  objectStore.createIndex("year", "year", { unique: false });
});

这是同一个示例，但使用 onupgradeneeded 事件处理程序属性。

// Open the database
const dBOpenRequest = window.indexedDB.open("toDoList", 4);

dBOpenRequest.onupgradeneeded = (event) => {
  const db = event.target.result;
  console.log(`Upgrading to version ${db.version}`);

  // Create an objectStore for this database
  const objectStore = db.createObjectStore("toDoList", {
    keyPath: "taskTitle",
  });

  // define what data items the objectStore will contain
  objectStore.createIndex("hours", "hours", { unique: false });
  objectStore.createIndex("minutes", "minutes", { unique: false });
  objectStore.createIndex("day", "day", { unique: false });
  objectStore.createIndex("month", "month", { unique: false });
  objectStore.createIndex("year", "year", { unique: false });
};

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅

使用 IndexedDB