CKTIS / JavaScript
IDBVersionChangeEvent.oldVersion — a versão anterior da base de dados IndexedDB
A propriedade IDBVersionChangeEvent.oldVersion expõe o número da versão anterior de uma base de dados IndexedDB. Num evento upgradeneeded, ajuda a escolher as migrações necessárias; o valor 0 significa que a base de dados não existia anteriormente.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
event.oldVersionIDBVersionChangeEvent herda de Event e transporta informações sobre a versão de uma base de dados IndexedDB. A sua propriedade só de leitura IDBVersionChangeEvent.oldVersion contém o número da versão anterior como um number de JavaScript, não como uma cadeia de caracteres ou um BigInt.
O evento upgradeneeded de um IDBOpenDBRequest utiliza esta interface quando, para abrir uma base de dados, é necessário criá-la ou aumentar a sua versão. Se a base de dados não existia anteriormente, event.oldVersion é 0. Num processador de migrações, condições separadas como event.oldVersion < 1 e event.oldVersion < 2 permitem executar todos os passos em falta, mesmo quando são ignoradas versões intermédias.
Não confundas oldVersion com newVersion: a primeira descreve a versão anterior e a segunda, a versão de destino. O exemplo cria apenas eventos sintéticos, pelo que não efetua migrações nem demonstra que uma atualização da base de dados tenha sido bem-sucedida. Esta é uma API do navegador, não uma funcionalidade da linguagem ECMAScript; a disponibilidade do construtor deve ser verificada separadamente do suporte da própria propriedade.
Exemplos
(() => {
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);
})();Resultado
0 2
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.