Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

indexedDB.open — otvaranje baze podataka i nadogradnja njezine sheme

indexedDB.open asinkrono otvara ili stvara lokalnu bazu podataka. Vraća zahtjev kojim upravljaju događaji; promjene sheme pripadaju rukovatelju događaja upgradeneeded.

Verzija: 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) vraća IDBOpenDBRequest, a ne Promise. Pri događaju success, request.result sadrži vezu IDBDatabase. Ako izostavite version, koristi se trenutačna verzija baze podataka ili 1 za novu bazu.

Verzija je pozitivan cijeli broj. Viša verzija pokreće upgradeneeded: unutar te transakcije nadogradnje izradite spremišta objekata i indekse. success se događa tek nakon potvrde nadogradnje. Niža verzija uzrokuje asinkroni VersionError; 0 izaziva sinkroni TypeError.

Druge otvorene veze mogu uzrokovati blocked; to znači da se čeka, a ne da je postupak konačno neuspješan. Kao odgovor na versionchange zatvorite ih pomoću db.close(). Obradite i error i sinkrone iznimke.

Ovo je Web API, a ne dio ECMAScripta. Dostupnost provjerite u ciljnom pregledniku; Node 24 to ne potvrđuje. Pravila pohrane mogu uskratiti pristup. Ako otvaranje uspije, primjer zatvara vezu i pozivom indexedDB.deleteDatabase(name) traži brisanje baze podataka. U prikazanom slučaju s pogreškom SecurityError baza podataka se ne stvara.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori