IDBVersionChangeEvent
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.
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
Specification |
---|
Indexed Database API 3.0 # events |
Browser-Kompatibilität
BCD tables only load in the browser
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).