CKTIS / JavaScript
IDBVersionChangeEvent.oldVersion — předchozí verze databáze IndexedDB
Vlastnost IDBVersionChangeEvent.oldVersion zpřístupňuje předchozí číslo verze databáze IndexedDB. Při události upgradeneeded pomáhá vybrat potřebné migrace; hodnota 0 znamená, že databáze dříve neexistovala.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.oldVersionIDBVersionChangeEvent dědí z Event a nese informace o verzi databáze IndexedDB. Jeho vlastnost IDBVersionChangeEvent.oldVersion je pouze pro čtení a obsahuje předchozí číslo verze jako JavaScriptový number, nikoli jako řetězec nebo BigInt.
Událost upgradeneeded objektu IDBOpenDBRequest používá toto rozhraní, pokud je při otevření databáze nutné ji vytvořit nebo zvýšit její verzi. Pokud databáze dříve neexistovala, event.oldVersion má hodnotu 0. V obslužné rutině migrace umožňují samostatné podmínky, například event.oldVersion < 1 a event.oldVersion < 2, provést všechny chybějící kroky, i když jsou některé mezilehlé verze přeskočeny.
Nezaměňujte oldVersion a newVersion: první popisuje předchozí verzi, druhá cílovou verzi. Příklad vytváří pouze syntetické události, takže neprovádí migraci ani nedokazuje, že aktualizace databáze proběhla úspěšně. Jde o rozhraní API prohlížeče, nikoli o funkci jazyka ECMAScript; dostupnost konstruktoru je nutné ověřit zvlášť, nezávisle na podpoře samotné vlastnosti.
Příklady
(() => {
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);
})();Výsledek
0 2
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.