IDBVersionChangeEvent

Das IDBVersionChangeEvent-Interface der IndexedDB API zeigt an, dass sich die Version der Datenbank geändert hat, als Ergebnis einer onupgradeneeded Event-Handler-Funktion.

Konstruktor

IDBVersionChangeEvent()

Erstellt und gibt ein neues IDBVersionChangeEvent-Objekt zurück, das verwendet wird, um darzustellen, wann sich eine Version der Datenbank geändert hat.

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem Elterninterface, Event.

IDBVersionChangeEvent.oldVersion Schreibgeschützt

Gibt die alte Version der Datenbank zurück.

IDBVersionChangeEvent.newVersion Schreibgeschützt

Gibt die neue Version der Datenbank zurück.

Instanz-Methoden

Keine spezifische Methode, aber erbt Methoden von seinem Elterninterface, Event.

Beispiel

Im folgenden Codebeispiel wird eine Anfrage zum Öffnen einer Datenbank gemacht, und es werden Handler für die Erfolgs- und Fehlerfälle inkludiert. Bei einer Versionsänderung (nach einem upgradeneeded-Ereignis) wird das success-Ereignis das IDBVersionChangeEvent-Interface implementieren. Für ein vollständiges funktionierendes Beispiel, siehe unsere To-do Notifications App (Beispiel live ansehen).

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung von IndexedDB
• Starten von Transaktionen: IDBDatabase
• Verwendung von Transaktionen: IDBTransaction
• Festlegen eines Schlüsselbereichs: IDBKeyRange
• Abrufen und Ändern Ihrer Daten: IDBObjectStore
• Verwendung von Cursoren: IDBCursor
• Referenzbeispiel: To-do Notifications (Beispiel live ansehen).