IDBVersionChangeEvent: newVersion Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die newVersion-Eigenschaft des schreibgeschützten IDBVersionChangeEvent Interfaces gibt die neue Versionsnummer der Datenbank zurück.

Wert

Eine Zahl, die ein 64-Bit-Ganzzahlwert ist, oder null, wenn die Datenbank gelöscht wird.

Beispiele

Im folgenden Code-Snippet machen wir eine Anfrage zum Öffnen einer Datenbank und fügen Handler für die Erfolgs- und Fehlerfälle hinzu. Diese Ereignisse werden über das benutzerdefinierte IDBVersionChangeEvent-Interface ausgelöst. Für ein vollständiges funktionierendes Beispiel, siehe unsere To-do Notifications App (Beispiel live ansehen).

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;
};

Spezifikationen

Specification
Indexed Database API 3.0
# dom-idbversionchangeevent-newversion

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch