IDBVersionChangeEvent
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
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.oldVersionSchreibgeschützt-
Gibt die alte Version der Datenbank zurück.
IDBVersionChangeEvent.newVersionSchreibgeschü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
Loading…
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).