CKTIS / JavaScript
indexedDB.open — ouvrir une base de données et mettre à jour son schéma
indexedDB.open ouvre ou crée une base de données locale de façon asynchrone. La méthode renvoie une requête pilotée par des événements ; les modifications du schéma se font dans le gestionnaire upgradeneeded.
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
indexedDB.open(name)
indexedDB.open(name, version)indexedDB.open(name, version) renvoie un IDBOpenDBRequest, pas une Promise. Lors de success, request.result contient une connexion IDBDatabase. Si version est omis, la version actuelle de la base est utilisée, ou 1 pour une nouvelle base.
La version est un entier positif. Une version supérieure déclenche upgradeneeded : créez les magasins d’objets et les index dans cette transaction de mise à niveau. success ne survient qu’après la validation de la mise à niveau. Une version inférieure provoque une erreur asynchrone VersionError ; 0 déclenche une erreur synchrone TypeError.
D’autres connexions ouvertes peuvent provoquer blocked ; cela signifie que l’opération attend, et non qu’elle a définitivement échoué. Fermez-les avec db.close() en réponse à versionchange. Gérez à la fois error et les exceptions synchrones.
Il s’agit d’une Web API, qui ne fait pas partie d’ECMAScript. Vérifiez sa disponibilité dans le navigateur cible ; Node 24 ne permet pas de l’établir. La politique de stockage peut refuser l’accès. Si l’ouverture réussit, l’exemple ferme la connexion et demande la suppression de la base avec indexedDB.deleteDatabase(name). Dans le cas illustré, où une erreur SecurityError se produit, aucune base n’est créée.
Exemples
(() => {
const name = `cktis-open-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
const failed = error => console.log(`Open failed: ${error.name}`);
try {
const request = indexedDB.open(name, 1);
let upgradedFrom;
request.onupgradeneeded = event => {
upgradedFrom = event.oldVersion;
request.result.createObjectStore('notes');
};
request.onblocked = () => console.log('Open blocked by an open connection');
request.onerror = () => failed(request.error);
request.onsuccess = () => {
const db = request.result;
const version = db.version;
const hasNotes = db.objectStoreNames.contains('notes');
db.close();
indexedDB.deleteDatabase(name);
console.log(`Opened version ${version} from ${upgradedFrom}; notes store: ${hasNotes}`);
};
} catch (error) {
failed(error);
}
})();Résultat
Open failed: SecurityError
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.