Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

IDBVersionChangeEvent.oldVersion — predchádzajúca verzia databázy IndexedDB

Vlastnosť IDBVersionChangeEvent.oldVersion sprístupňuje predchádzajúce číslo verzie databázy IndexedDB. Pri udalosti upgradeneeded pomáha vybrať potrebné migrácie; hodnota 0 znamená, že databáza predtým neexistovala.

Verzia: 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 dedí z Event a nesie informácie o verzii databázy IndexedDB. Jeho vlastnosť IDBVersionChangeEvent.oldVersion je iba na čítanie a obsahuje predchádzajúce číslo verzie ako JavaScriptový number, nie ako reťazec ani BigInt.

Udalosť upgradeneeded objektu IDBOpenDBRequest používa toto rozhranie, keď je pri otvorení databázy potrebné vytvoriť ju alebo zvýšiť jej verziu. Ak databáza predtým neexistovala, event.oldVersion má hodnotu 0. V obslužnej rutine migrácie umožňujú samostatné podmienky, napríklad event.oldVersion < 1 a event.oldVersion < 2, vykonať všetky chýbajúce kroky, aj keď sa preskočia medziľahlé verzie.

Nezamieňajte oldVersion s newVersion: prvá opisuje predchádzajúcu verziu, druhá cieľovú verziu. Príklad vytvára iba syntetické udalosti, takže nevykonáva migráciu ani nedokazuje, že aktualizácia databázy uspela. Ide o rozhranie API prehliadača, nie o funkciu jazyka ECMAScript; dostupnosť konštruktora treba overiť osobitne, nezávisle od podpory samotnej vlastnosti.

Prí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ýsledok

0
2

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje