WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

IDBVersionChangeEvent.oldVersion — die vorherige IndexedDB-Datenbankversion

Die Eigenschaft IDBVersionChangeEvent.oldVersion gibt die vorherige Versionsnummer einer IndexedDB-Datenbank an. Bei einem upgradeneeded-Ereignis hilft sie dabei, die erforderlichen Migrationen auszuwählen; 0 bedeutet, dass die Datenbank zuvor nicht existierte.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

event.oldVersion

IDBVersionChangeEvent erbt von Event und enthält Informationen zur Version einer IndexedDB-Datenbank. Seine schreibgeschützte Eigenschaft IDBVersionChangeEvent.oldVersion enthält die vorherige Versionsnummer als JavaScript-number, nicht als Zeichenfolge oder BigInt.

Das Ereignis upgradeneeded eines IDBOpenDBRequest verwendet diese Schnittstelle, wenn zum Öffnen einer Datenbank ihre Erstellung oder eine Erhöhung ihrer Version erforderlich ist. Wenn die Datenbank zuvor nicht existierte, ist event.oldVersion gleich 0. In einer Migrationsroutine ermöglichen getrennte Bedingungen wie event.oldVersion < 1 und event.oldVersion < 2, alle fehlenden Schritte auszuführen, auch wenn Zwischenversionen übersprungen werden.

Verwechsle oldVersion nicht mit newVersion: Ersteres beschreibt die vorherige Version, Letzteres die Zielversion. Das Beispiel erstellt nur synthetische Ereignisse und führt daher weder eine Migration durch noch weist es nach, dass ein Datenbank-Upgrade erfolgreich war. Dies ist eine Browser-API und kein Bestandteil der ECMAScript-Sprache; die Verfügbarkeit des Konstruktors muss unabhängig von der Unterstützung der Eigenschaft selbst geprüft werden.

Beispiele

(() => {
  const firstCreation = new IDBVersionChangeEvent("upgradeneeded", {
    oldVersion: 0,
    newVersion: 3,
  });
  const upgrade = new IDBVersionChangeEvent("upgradeneeded", {
    oldVersion: 2,
    newVersion: 3,
  });

  console.log(firstCreation.oldVersion);
  console.log(upgrade.oldVersion);
})();

Ergebnis

0
2

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen