Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

IDBVersionChangeEvent.oldVersion — prejšnja različica zbirke podatkov IndexedDB

Lastnost IDBVersionChangeEvent.oldVersion razkriva prejšnjo številko različice zbirke podatkov IndexedDB. Pri dogodku upgradeneeded pomaga izbrati potrebne migracije; vrednost 0 pomeni, da zbirka podatkov prej ni obstajala.

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

Sintaksa

event.oldVersion

IDBVersionChangeEvent podeduje od Event in vsebuje informacije o različici zbirke podatkov IndexedDB. Njegova lastnost IDBVersionChangeEvent.oldVersion je samo za branje in vsebuje prejšnjo številko različice kot JavaScriptov number, ne kot niz ali BigInt.

Dogodek upgradeneeded na objektu IDBOpenDBRequest uporablja ta vmesnik, kadar je treba zbirko podatkov ob odpiranju ustvariti ali povečati njeno različico. Če zbirka podatkov prej ni obstajala, je event.oldVersion enak 0. V obravnavalniku migracij ločeni pogoji, kot sta event.oldVersion < 1 in event.oldVersion < 2, omogočijo izvedbo vseh manjkajočih korakov, tudi če so vmesne različice izpuščene.

Ne zamenjujte oldVersion z newVersion: prva opisuje prejšnjo različico, druga ciljno različico. Primer ustvari samo sintetične dogodke, zato ne izvede migracije in ne dokazuje, da je bila nadgradnja zbirke podatkov uspešna. To je API brskalnika, ne funkcija jezika ECMAScript; razpoložljivost konstruktorja je treba preveriti ločeno od podpore za samo lastnost.

Primeri

(() => {
  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);
})();

Rezultat

0
2

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri