Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła