Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

IDBVersionChangeEvent.oldVersion — la version précédente de la base IndexedDB

La propriété IDBVersionChangeEvent.oldVersion expose le numéro de version précédent d’une base IndexedDB. Dans un événement upgradeneeded, elle aide à choisir les migrations nécessaires ; la valeur 0 signifie que la base n’existait pas auparavant.

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

Syntaxe

event.oldVersion

IDBVersionChangeEvent hérite de Event et transporte des informations sur la version d’une base IndexedDB. Sa propriété en lecture seule IDBVersionChangeEvent.oldVersion contient le numéro de version précédent sous la forme d’un number JavaScript, et non d’une chaîne ou d’un BigInt.

L’événement upgradeneeded d’un IDBOpenDBRequest utilise cette interface lorsque l’ouverture d’une base nécessite de la créer ou d’augmenter sa version. Si la base n’existait pas auparavant, event.oldVersion vaut 0. Dans un gestionnaire de migration, des conditions distinctes telles que event.oldVersion < 1 et event.oldVersion < 2 permettent d’exécuter toutes les étapes manquantes, même si des versions intermédiaires sont ignorées.

Ne confondez pas oldVersion et newVersion : le premier décrit la version précédente, le second la version cible. L’exemple construit uniquement des événements synthétiques ; il n’effectue donc aucune migration et ne prouve pas qu’une mise à niveau de la base a réussi. Il s’agit d’une API de navigateur, et non d’une fonctionnalité du langage ECMAScript ; la disponibilité du constructeur doit être vérifiée indépendamment de la prise en charge de la propriété elle-même.

Exemples

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

Résultat

0
2

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources