CKTIS / JavaScript
IDBDatabase — připojení k databázi IndexedDB
IDBDatabase představuje otevřené připojení k databázi IndexedDB. Umožňuje vytvářet úložiště během aktualizace schématu, spouštět transakce a připojení zavřít.
Verze: 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();IDBDatabase získáš jako request.result po úspěšném dokončení indexedDB.open(). Jde o Web API, nikoli o součást ECMAScriptu; Node 24 nepotvrzuje podporu v prohlížečích. Ověř, zda je v cílovém prostředí dostupné indexedDB; citované specifikace nejsou tabulkami kompatibility prohlížečů.
IDBDatabase.createObjectStore() funguje pouze v aktivní aktualizační transakci, obvykle v upgradeneeded. IDBDatabase.objectStoreNames vrací seřazený seznam názvů typu DOMStringList, nikoli pole. Před vytvořením úložiště lze podle potřeby použít .contains().
IDBDatabase.transaction() určuje rozsah úložišť a režim: výchozí readonly nebo readwrite. Ručně vytvořit transakci versionchange tímto způsobem nelze. Operace zařazuj, dokud je transakce aktivní; nepředpokládej, že přežije libovolná volání await. Úspěch požadavku neznamená potvrzení transakce: počkej na její complete.
V reakci na požadavek na otevření databáze s vyšším číslem verze nebo na její odstranění odešle IndexedDB událost IDBDatabase.versionchange stávajícím připojením k databázi s výjimkou těch, která mají nastavený příznak close pending. Tato připojení událost neobdrží, ani když zůstanou otevřená až do dokončení probíhajících transakcí. K podání požadavku není potřeba otevřené připojení a požadavek na odstranění žádné připojení neotevírá. Událost zpracuj pomocí onversionchange. Liší se od upgradeneeded. IDBDatabase.close() zabrání novým transakcím a zavře připojení po dokončení stávajících, aniž by odstranilo data. Otevřená připojení mohou blokovat aktualizace.
Příklady
<!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>Výsledek
Hello
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.