Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

indexedDB.open — odpiranje podatkovne zbirke in posodobitev njene sheme

indexedDB.open asinhrono odpre ali ustvari lokalno podatkovno zbirko. Vrne zahtevo, ki jo upravljajo dogodki; spremembe sheme sodijo v obravnavo dogodka upgradeneeded.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

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

indexedDB.open(name, version) vrne IDBOpenDBRequest, ne Promise. Ob dogodku success je v request.result povezava IDBDatabase. Če version izpustite, se uporabi trenutna različica zbirke ali 1 za novo zbirko.

Različica je pozitivno celo število. Višja različica sproži upgradeneeded: v tej transakciji nadgradnje ustvarite shrambe objektov in indekse. success nastopi šele po potrditvi nadgradnje. Nižja različica povzroči asinhrono napako VersionError; 0 sproži sinhrono napako TypeError.

Druge odprte povezave lahko sprožijo blocked; to pomeni čakanje, ne dokončne napake. Kot odziv na versionchange jih zaprite z db.close(). Obravnavajte tako error kot sinhrone izjeme.

To je spletni API, ne del ECMAScript. Razpoložljivost preverite v ciljnem brskalniku; Node 24 tega ne dokazuje. Politika shranjevanja lahko dostop zavrne. Če je odpiranje uspešno, primer zapre povezavo in z indexedDB.deleteDatabase(name) zahteva izbris podatkovne zbirke. V prikazanem primeru z napako SecurityError se podatkovna zbirka ne ustvari.

Primeri

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

Rezultat

Open failed: SecurityError

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri