KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

IDBVersionChangeEvent.oldVersion — de vorige IndexedDB-databaseversie

De eigenschap IDBVersionChangeEvent.oldVersion geeft het vorige versienummer van een IndexedDB-database weer. Bij een upgradeneeded-gebeurtenis helpt deze eigenschap de vereiste migraties te kiezen; 0 betekent dat de database eerder niet bestond.

Versie: 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 erft van Event en bevat informatie over de versie van een IndexedDB-database. De alleen-lezen eigenschap IDBVersionChangeEvent.oldVersion bevat het vorige versienummer als een JavaScript-number, niet als een tekenreeks of BigInt.

De gebeurtenis upgradeneeded van een IDBOpenDBRequest gebruikt deze interface wanneer een database bij het openen moet worden aangemaakt of een hoger versienummer moet krijgen. Als de database eerder niet bestond, is event.oldVersion gelijk aan 0. In een migratiehandler zorgen afzonderlijke voorwaarden zoals event.oldVersion < 1 en event.oldVersion < 2 ervoor dat alle ontbrekende stappen worden uitgevoerd, ook wanneer tussenliggende versies worden overgeslagen.

Verwar oldVersion niet met newVersion: de eerste beschrijft de vorige versie, de tweede de doelversie. Het voorbeeld maakt alleen synthetische gebeurtenissen aan en voert dus geen migratie uit en bewijst niet dat een database-upgrade is geslaagd. Dit is een browser-API, geen functie van de ECMAScript-taal; controleer de beschikbaarheid van de constructor afzonderlijk van de ondersteuning voor de eigenschap zelf.

Voorbeelden

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

Resultaat

0
2

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen