Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

IDBVersionChangeEvent.oldVersion — la versión anterior de la base de datos IndexedDB

La propiedad IDBVersionChangeEvent.oldVersion expone el número de versión anterior de una base de datos IndexedDB. En un evento upgradeneeded, ayuda a elegir las migraciones necesarias; el valor 0 significa que la base de datos no existía anteriormente.

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

Sintaxis

event.oldVersion

IDBVersionChangeEvent hereda de Event y contiene información sobre la versión de una base de datos IndexedDB. Su propiedad de solo lectura IDBVersionChangeEvent.oldVersion contiene el número de versión anterior como un number de JavaScript, no como una cadena ni como un BigInt.

El evento upgradeneeded de un IDBOpenDBRequest usa esta interfaz cuando para abrir una base de datos es necesario crearla o aumentar su versión. Si la base de datos no existía anteriormente, event.oldVersion vale 0. En un controlador de migraciones, condiciones independientes como event.oldVersion < 1 y event.oldVersion < 2 permiten ejecutar todos los pasos que faltan, incluso si se omiten versiones intermedias.

No confundas oldVersion con newVersion: la primera describe la versión anterior y la segunda, la versión de destino. El ejemplo solo construye eventos sintéticos, así que no realiza ninguna migración ni demuestra que se haya completado correctamente una actualización de la base de datos. Esta es una API del navegador, no una característica del lenguaje ECMAScript; la disponibilidad del constructor debe comprobarse por separado de la compatibilidad con la propiedad en sí.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes