IDBVersionChangeEvent

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 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.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.

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

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).