CKTIS / JavaScript
IDBVersionChangeEvent.oldVersion — poprzednia wersja bazy IndexedDB
Właściwość IDBVersionChangeEvent.oldVersion udostępnia poprzedni numer wersji bazy IndexedDB. W zdarzeniu upgradeneeded pomaga wybrać potrzebne migracje; wartość 0 oznacza, że baza wcześniej nie istniała.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
event.oldVersionIDBVersionChangeEvent dziedziczy po Event i przenosi informacje o wersjach bazy IndexedDB. Jego właściwość IDBVersionChangeEvent.oldVersion jest tylko do odczytu: zawiera poprzedni numer wersji jako wartość JavaScript typu number, a nie tekst ani BigInt.
Zdarzenie upgradeneeded na IDBOpenDBRequest korzysta z tego interfejsu, gdy otwarcie bazy wymaga utworzenia jej lub podniesienia wersji. Jeśli baza wcześniej nie istniała, event.oldVersion wynosi 0. W procedurze migracji oddzielne warunki, takie jak event.oldVersion < 1 i event.oldVersion < 2, pozwalają wykonać wszystkie brakujące kroki, także przy pominięciu wersji pośrednich.
Nie myl oldVersion z newVersion: pierwsza właściwość opisuje wersję poprzednią, druga docelową. Przykład tworzy wyłącznie syntetyczne zdarzenia, więc nie przeprowadza migracji ani nie dowodzi powodzenia aktualizacji bazy. To API przeglądarkowe, nie funkcja języka ECMAScript; dostępność konstruktora trzeba sprawdzić osobno od obsługi samej właściwości.
Przykłady
(() => {
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);
})();Wynik
0 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.