IDBVersionChangeEvent: newVersion 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

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

IDBVersionChangeEvent 介面的 newVersion 只讀屬性返回資料庫的新版本號。

一個 64 位整數或 null(如果資料庫正在被刪除)。

示例

在以下程式碼片段中,我們請求開啟一個數據庫,幷包含成功和錯誤情況的處理程式。這些事件是透過自定義的 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
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
# dom-idbversionchangeevent-newversion

瀏覽器相容性

另見