CKTIS / JavaScript
IDBDatabase — eine IndexedDB-Datenbankverbindung
IDBDatabase steht für eine offene Verbindung zu einer IndexedDB-Datenbank. Damit lassen sich während Schemaaktualisierungen Objektspeicher erstellen, Transaktionen starten und die Verbindung schließen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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();Ein IDBDatabase erhältst du als request.result, nachdem indexedDB.open() erfolgreich war. Dies ist eine Web API und kein Bestandteil von ECMAScript; Node 24 belegt keine Browserunterstützung. Prüfe, ob indexedDB in der Zielumgebung vorhanden ist. Die zitierten Spezifikationen sind keine Browser-Kompatibilitätstabellen.
IDBDatabase.createObjectStore() funktioniert nur innerhalb einer aktiven Aktualisierungstransaktion, normalerweise in upgradeneeded. IDBDatabase.objectStoreNames liefert eine sortierte DOMStringList mit Namen, kein Array. Bei Bedarf kannst du vor dem Erstellen eines Speichers .contains() verwenden.
IDBDatabase.transaction() legt den Speicherbereich und den Modus fest: standardmäßig readonly oder readwrite. Eine versionchange-Transaktion lässt sich damit nicht manuell erstellen. Füge Operationen hinzu, solange die Transaktion aktiv ist; gehe nicht davon aus, dass sie beliebige await-Aufrufe übersteht. Der Erfolg einer Anfrage bedeutet nicht, dass die Transaktion festgeschrieben wurde: Warte auf complete der Transaktion.
Wenn angefordert wird, die Datenbank mit einer höheren Versionsnummer zu öffnen oder sie zu löschen, sendet IndexedDB das Ereignis IDBDatabase.versionchange an bestehende Verbindungen zur Datenbank, bei denen das Flag close pending nicht gesetzt ist. Verbindungen mit gesetztem Flag erhalten das Ereignis auch dann nicht, wenn sie bis zum Abschluss ihrer laufenden Transaktionen offen bleiben. Für die Anfrage ist keine bestehende Verbindung erforderlich, und eine Löschanfrage öffnet keine Verbindung. Behandle das Ereignis mit onversionchange. Es ist nicht dasselbe wie upgradeneeded. IDBDatabase.close() verhindert neue Transaktionen und schließt die Verbindung, nachdem bestehende abgeschlossen sind, ohne Daten zu löschen. Offen gelassene Verbindungen können Aktualisierungen blockieren.
Beispiele
<!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>Ergebnis
Hello
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.