Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

IDBVersionChangeEvent.oldVersion — la versione precedente del database IndexedDB

La proprietà IDBVersionChangeEvent.oldVersion espone il numero di versione precedente di un database IndexedDB. In un evento upgradeneeded aiuta a scegliere le migrazioni necessarie; il valore 0 significa che il database non esisteva in precedenza.

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

Sintassi

event.oldVersion

IDBVersionChangeEvent eredita da Event e contiene informazioni sulla versione di un database IndexedDB. La sua proprietà di sola lettura IDBVersionChangeEvent.oldVersion contiene il numero di versione precedente come number JavaScript, non come stringa o BigInt.

L’evento upgradeneeded di un IDBOpenDBRequest usa questa interfaccia quando per aprire un database è necessario crearlo o aumentarne la versione. Se il database non esisteva in precedenza, event.oldVersion vale 0. In un gestore delle migrazioni, condizioni separate come event.oldVersion < 1 e event.oldVersion < 2 consentono di eseguire tutti i passaggi mancanti, anche quando vengono saltate versioni intermedie.

Non confondere oldVersion con newVersion: la prima descrive la versione precedente, la seconda quella di destinazione. L’esempio crea soltanto eventi sintetici, quindi non esegue migrazioni né dimostra che l’aggiornamento di un database sia riuscito. Questa è un’API del browser, non una funzionalità del linguaggio ECMAScript; la disponibilità del costruttore va verificata separatamente dal supporto della proprietà stessa.

Esempi

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

Risultato

0
2

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti