Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

IDBDatabase — pripojenie k databáze IndexedDB

IDBDatabase predstavuje otvorené pripojenie k databáze IndexedDB. Umožňuje vytvárať úložiská počas aktualizácie schémy, spúšťať transakcie a zatvoriť pripojenie.

Verzia: 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();

IDBDatabase získaš ako request.result po úspešnom dokončení indexedDB.open(). Ide o Web API, nie o súčasť ECMAScriptu; Node 24 nepotvrdzuje podporu v prehliadačoch. Over, či je v cieľovom prostredí dostupné indexedDB; citované špecifikácie nie sú tabuľkami kompatibility prehliadačov.

IDBDatabase.createObjectStore() funguje iba v aktívnej aktualizačnej transakcii, zvyčajne v upgradeneeded. IDBDatabase.objectStoreNames vracia usporiadaný zoznam názvov typu DOMStringList, nie pole. Pred vytvorením úložiska môžeš podľa potreby použiť .contains().

IDBDatabase.transaction() určuje rozsah úložísk a režim: predvolený readonly alebo readwrite. Transakciu versionchange týmto spôsobom nemožno vytvoriť ručne. Operácie zaraď, kým je transakcia aktívna; nepredpokladaj, že prežije ľubovoľné volania await. Úspech požiadavky neznamená potvrdenie transakcie: počkaj na jej complete.

V reakcii na požiadavku na otvorenie databázy s vyšším číslom verzie alebo na jej odstránenie odošle IndexedDB udalosť IDBDatabase.versionchange existujúcim pripojeniam k databáze okrem tých, ktoré majú nastavený príznak close pending. Tieto pripojenia udalosť nedostanú ani vtedy, ak zostanú otvorené až do dokončenia prebiehajúcich transakcií. Na zadanie požiadavky netreba otvorené pripojenie a požiadavka na odstránenie žiadne pripojenie neotvára. Udalosť spracuj pomocou onversionchange. Líši sa od upgradeneeded. IDBDatabase.close() zabráni novým transakciám a zatvorí pripojenie po dokončení existujúcich, bez odstránenia údajov. Otvorené pripojenia môžu blokovať aktualizácie.

Prí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ýsledok

Hello

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje