IDBOpenDBRequest：upgradeneeded 事件
當嘗試開啟資料庫時，如果指定的版本號高於當前版本號，則會觸發 upgradeneeded 事件。
此事件不可取消，也不會冒泡。
語法
在諸如 addEventListener() 之類的方法中使用事件名稱，或設定事件處理程式屬性。
js
addEventListener("upgradeneeded", (event) => { })
onupgradeneeded = (event) => { }
事件型別
一個 IDBVersionChangeEvent。繼承自 Event。
事件屬性
也繼承自其父介面 Event 的屬性。
IDBVersionChangeEvent.oldVersion只讀-
返回資料庫的舊版本。
IDBVersionChangeEvent.newVersion只讀-
返回資料庫的新版本。
示例
此示例開啟一個數據庫，並透過對物件儲存進行必要的更新來處理 upgradeneeded 事件。
js
// 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 事件處理程式屬性。
js
// 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 });
};
規範
| 規範 |
|---|
| Indexed Database API 3.0 # eventdef-idbopendbrequest-upgradeneeded |
瀏覽器相容性
載入中…