Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

IndexedDB: izrada indeksa, umetanje, brojanje i čitanje zapisa

Izradi sekundarni indeks, umetni zapise bez prepisivanja i pretraži ih prema primarnom ključu ili ključu indeksa.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

store.createIndex(name, keyPath)
store.createIndex(name, keyPath, options)
store.count()
store.count(query)
store.add(value)
store.add(value, key)
store.getAll()
store.getAll(query)
store.getAll(query, count)
store.getAll(options)
store.index(name)

IDBObjectStore predstavlja spremište objekata vezano uz transakciju. Svaki zapis ima primarni ključ i vrijednost. IndexedDB je web API, a ne dio ECMAScripta; pristup se ravna prema pravilima istog izvora.

createIndex(name, keyPath, options) odmah vraća IDBIndex, ali se može pozvati samo u aktivnoj transakciji versionchange, obično u obradi događaja upgradeneeded. Put ključa određuje odakle se uzima ključ indeksa i ne dodaje polje zapisu. unique: true zabranjuje duplicirane ključeve indeksa, a multiEntry: true zasebno indeksira valjane elemente niza. Obje opcije zadano imaju vrijednost false. multiEntry: true ne može se kombinirati sa složenim putem ključa zadanim kao niz putova.

add(value, key) sprema strukturiranu kopiju i daje novi ključ u request.result. Izostavi drugi argument ako je ključ unutar vrijednosti; navedi ga ako je ključ odvojen, a generatora nema. Duplicirani primarni ključ ili kršenje jedinstvenosti indeksa uzrokuje pogrešku zahtjeva ConstraintError. Za umetanje ili zamjenu prema primarnom ključu upotrijebi put().

count(query) daje broj, a getAll(query, count) niz kopija vrijednosti, prazan ako nema podudaranja. Obje metode prihvaćaju primarni ključ ili IDBKeyRange i bez filtra obuhvaćaju cijelo spremište. Pozitivan count ograničava broj vrijednosti iz getAll(). Zadani je redoslijed uzlazan po primarnom ključu. Noviji oblik getAll({ query, count, direction }) omogućuje, primjerice, "prev"; provjeri podršku u ciljnom pregledniku.

index(name) odmah vraća postojeći IDBIndex iz iste transakcije. Nepoznato ime izaziva NotFoundError; razlikuju se velika i mala slova. store.getAll("sci-fi") traži prema primarnom ključu, dok store.index("byGenre").getAll("sci-fi") vraća vrijednosti zapisa prema ključu indeksa.

add(), count() i getAll() vraćaju IDBRequest, ne Promise. Čitaj result nakon success i obradi error. U običnoj transakciji pisanje traži način rada readwrite. Predaj zahtjeve dok je transakcija aktivna: čekanje druge asinkrone operacije može dopustiti da završi. Uspjeh zahtjeva još ne potvrđuje transakciju; pričekaj njezin događaj complete.

Primjeri

<!doctype html>
<meta charset="utf-8">
<title>IndexedDB object store methods</title>
<script>
(() => {
  const dbName = `cktis-books-${crypto.randomUUID()}`;
  const open = indexedDB.open(dbName, 1);

  open.onupgradeneeded = () => {
    const store = open.result.createObjectStore('books', { keyPath: 'id' });
    store.createIndex('byGenre', 'genre');
  };
  open.onerror = () => console.error(open.error);

  open.onsuccess = () => {
    const db = open.result;
    const tx = db.transaction('books', 'readwrite');
    const store = tx.objectStore('books');

    const cleanup = () => {
      db.close();
      const deletion = indexedDB.deleteDatabase(dbName);
      deletion.onerror = () => console.error(deletion.error);
    };
    tx.onabort = () => {
      console.error(tx.error);
      cleanup();
    };

    const added = store.add({ id: 3, title: 'Orbit', genre: 'sci-fi' });
    store.add({ id: 1, title: 'Dunes', genre: 'sci-fi' });
    store.add({ id: 2, title: 'Herbs', genre: 'guide' });
    const total = store.count();
    const all = store.getAll();
    const matches = store.index('byGenre').getAll('sci-fi');

    tx.oncomplete = () => {
      const titles = (request) => request.result.map((book) => book.title).join(', ');
      console.log(`Added key: ${added.result}`);
      console.log(`Total: ${total.result}`);
      console.log(`All: ${titles(all)}`);
      console.log(`Sci-fi: ${titles(matches)}`);
      cleanup();
    };
  };
})();
</script>

Rezultat

Added key: 3
Total: 3
All: Dunes, Herbs, Orbit
Sci-fi: Dunes, Orbit

Posluži ovaj HTML dokument putem HTTPS-a, otvori ga u pregledniku i pogledaj razvojnu konzolu. Primjer stvara zasebnu privremenu bazu i potom je briše. Umeće tri knjige mimo redoslijeda primarnih ključeva, a nakon potvrde transakcije ispisuje sve naslove prema `id` i naslove odabrane indeksom žanra.

Povezane lekcije

  • JavaScript · Lekcija 21 · Srednje · Verzija: 3

Izvori