CKTIS / JavaScript
IDBDatabase — une connexion à une base IndexedDB
IDBDatabase représente une connexion ouverte à une base de données IndexedDB. Elle permet de créer des magasins lors des mises à jour du schéma, de démarrer des transactions et de fermer la connexion.
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
const request = indexedDB.open(name, version);
// In upgradeneeded:
const store = request.result.createObjectStore(storeName, options);
// After open succeeds:
const db = request.result;
db.objectStoreNames;
const tx = db.transaction(storeNames, "readonly");
db.onversionchange = () => db.close();Vous obtenez un IDBDatabase dans request.result lorsque indexedDB.open() réussit. Il s’agit d’une API Web, et non d’un élément d’ECMAScript ; Node 24 ne permet pas d’établir la prise en charge par les navigateurs. Vérifiez la présence de indexedDB dans l’environnement cible ; les spécifications citées ne sont pas des tableaux de compatibilité des navigateurs.
IDBDatabase.createObjectStore() ne fonctionne que dans une transaction de mise à niveau active, généralement dans upgradeneeded. IDBDatabase.objectStoreNames renvoie une DOMStringList triée de noms, et non un tableau. Si nécessaire, utilisez .contains() avant de créer un magasin.
IDBDatabase.transaction() définit les magasins concernés et le mode : readonly par défaut ou readwrite. Cette méthode ne permet pas de créer manuellement une transaction versionchange. Planifiez les opérations tant que la transaction est active ; ne supposez pas qu’elle reste active après des appels await arbitraires. La réussite d’une requête ne signifie pas que la transaction est validée : attendez son événement complete.
En réponse à une demande d’ouverture de la base avec un numéro de version supérieur ou à une demande de suppression, IndexedDB envoie l’événement IDBDatabase.versionchange aux connexions existantes à la base, sauf à celles dont l’indicateur close pending est activé. Ces connexions ne reçoivent pas l’événement, même si elles restent ouvertes jusqu’à la fin de leurs transactions en cours. Il n’est pas nécessaire de disposer d’une connexion ouverte pour émettre la demande, et une demande de suppression n’ouvre pas de connexion. Gérez cet événement avec onversionchange. Il est distinct de upgradeneeded. IDBDatabase.close() empêche les nouvelles transactions et ferme la connexion lorsque les transactions existantes sont terminées, sans supprimer les données. Les connexions laissées ouvertes peuvent bloquer les mises à niveau.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Using an IDBDatabase connection</title>
</head>
<body>
<script>
(() => {
const name = `cktis-connection-${Date.now()}-${Math.random()}`;
const unavailable = () => console.log('IndexedDB unavailable in this context.');
let open;
try {
// Opening a connection requires a context that permits IndexedDB.
open = indexedDB.open(name, 1);
} catch {
unavailable();
return;
}
open.onerror = unavailable;
open.onupgradeneeded = () => {
open.result.createObjectStore('notes', { keyPath: 'id' });
};
open.onsuccess = () => {
const db = open.result;
const tx = db.transaction('notes', 'readwrite');
const store = tx.objectStore('notes');
store.put({ id: 1, text: 'Hello' });
const read = store.get(1);
function cleanup() {
db.close();
indexedDB.deleteDatabase(name);
}
tx.oncomplete = () => {
console.log(read.result.text);
cleanup();
};
tx.onabort = () => {
cleanup();
console.log('Database transaction aborted.');
};
};
})();
</script>
</body>
</html>Résultat
Hello
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.