Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

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

Fontes