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

CKTIS / JavaScript

indexedDB.open — otvorenie databázy a aktualizácia jej schémy

indexedDB.open asynchrónne otvorí alebo vytvorí miestnu databázu. Vráti požiadavku riadenú udalosťami; zmeny schémy patria do obslužnej funkcie upgradeneeded.

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

indexedDB.open(name)
indexedDB.open(name, version)

indexedDB.open(name, version) vracia IDBOpenDBRequest, nie Promise. Pri udalosti success obsahuje request.result pripojenie IDBDatabase. Ak version vynecháte, použije sa aktuálna verzia databázy, prípadne 1 pri novej databáze.

Verzia je kladné celé číslo. Vyššia verzia vyvolá upgradeneeded: v rámci tejto aktualizačnej transakcie vytvorte úložiská objektov a indexy. Udalosť success nastane až po potvrdení aktualizácie. Nižšia verzia spôsobí asynchrónny VersionError; hodnota 0 vyvolá synchrónny TypeError.

Iné otvorené pripojenia môžu spôsobiť udalosť blocked; znamená to čakanie, nie konečné zlyhanie. V reakcii na versionchange ich zatvorte pomocou db.close(). Ošetrite error aj synchrónne výnimky.

Ide o Web API, nie o súčasť ECMAScriptu. Dostupnosť overte v cieľovom prehliadači; Node 24 ju nedokazuje. Zásady úložiska môžu prístup odmietnuť. Ak sa databázu podarí otvoriť, príklad zatvorí pripojenie a pomocou indexedDB.deleteDatabase(name) požiada o odstránenie databázy. V zobrazenom prípade s chybou SecurityError sa žiadna databáza nevytvorí.

Príklady

(() => {
  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);
  }
})();

Výsledok

Open failed: SecurityError

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

Zdroje