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