Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

IDBObjectStore — spremište zapisa IndexedDB

IDBObjectStore izlaže zapise IndexedDB putem reference povezane s transakcijom. Omogućuje dodavanje, zamjenu, čitanje, brisanje i brojanje podataka te pristup sekundarnim indeksima.

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

const store = transaction.objectStore(name);
store.createIndex(name, keyPath, options); // upgrade transaction only
store.add(value, key); // key may be omitted
store.put(value, key); // key may be omitted
store.getAll(query, count); // query and count are optional
store.delete(query);
store.count(query); // query is optional
store.index(name);

IDBObjectStore je referenca na spremište zapisa IndexedDB, povezana s određenom transakcijom. Svaki zapis ima primarni ključ i vrijednost koja se kopira strukturiranim kloniranjem. keyPath: "id" uzima ključ iz polja id; uz ovu postavku nemojte proslijediti zaseban argument ključa metodama add() ili put().

add() umeće zapis; duplicirani ključ uzrokuje pogrešku ConstraintError. put() umeće zapis ili zamjenjuje cijelu vrijednost pod postojećim ključem — ne spaja polja. delete(query) uklanja zapise prema primarnom ključu ili rasponu ključeva. Za ove je operacije potrebna transakcija koja dopušta pisanje. getAll(query?, count?) dohvaća vrijednosti, prema zadanim postavkama poredane po uzlaznom primarnom ključu; count(query?) broji podudarne zapise. Ako izostavite upit, obuhvaćeno je cijelo spremište.

createIndex(name, keyPath, options) stvara indeks samo tijekom transakcije nadogradnje sheme, obično u onupgradeneeded; unique: true zahtijeva jedinstvene ključeve indeksa. index(name) vraća postojeći IDBIndex za pretraživanje prema sekundarnom ključu. Obje metode sinkrono vraćaju reference; ostale navedene metode vraćaju IDBRequest, a ne Promise.

Uspjeh zahtjeva ne znači da je transakcija potvrđena: pričekajte complete i obradite abort. Zadajte operacije dok je transakcija aktivna; čekanje na nepovezane asinkrone zadatke može je učiniti neaktivnom. Primjer upotrebljava oblike API-ja iz IndexedDB 2.0, bez novijeg preopterećenja getAll() s objektom opcija. Ovo je Web API, a ne dio ECMAScripta; Node 24 ne potvrđuje podršku u preglednicima. Provjerite je li indexedDB dostupan u ciljnom okruženju.

Referentni identifikatori obuhvaćeni ovim unosom: IDBObjectStore.createIndex, IDBObjectStore.add, IDBObjectStore.getAll, IDBObjectStore.delete, IDBObjectStore.put, IDBObjectStore.count, IDBObjectStore.index.

Primjeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IDBObjectStore: working with records</title>
</head>
<body>
  <h1>Working with an IndexedDB object store</h1>
  <script>
    (() => {
      const name = 'cktis-store-' + crypto.getRandomValues(new Uint32Array(4)).join('-');
      const report = error => console.log(error.name === 'SecurityError'
        ? 'IndexedDB unavailable: SecurityError' : `IndexedDB error: ${error.name}`);
      let factory, opening;
      try {
        factory = window.indexedDB;
        if (!factory) {
          console.log('IndexedDB unavailable: API missing');
          return;
        }
        opening = factory.open(name, 1);
      } catch (error) {
        report(error);
        return;
      }
      let created = false;
      opening.onerror = () => report(opening.error);
      opening.onupgradeneeded = () => {
        created = true;
        const store = opening.result.createObjectStore('items', { keyPath: 'id' });
        store.createIndex('byLabel', 'label', { unique: true });
      };
      opening.onsuccess = () => {
        const db = opening.result;
        if (!created) {
          db.close();
          console.log('Fixture name already in use');
          return;
        }
        const tx = db.transaction('items', 'readwrite');
        const store = tx.objectStore('items');
        store.add({ id: 1, label: 'draft' });
        store.add({ id: 2, label: 'spare' });
        store.put({ id: 1, label: 'final' });
        store.delete(2);
        const all = store.getAll();
        const count = store.count();
        const indexed = store.index('byLabel').get('final');
        const cleanup = () => {
          db.close();
          factory.deleteDatabase(name);
        };
        tx.oncomplete = () => {
          console.log(JSON.stringify({ items: all.result, count: count.result, indexedId: indexed.result.id }));
          cleanup();
        };
        tx.onabort = () => {
          report(tx.error);
          cleanup();
        };
      };
    })();
  </script>
</body>
</html>

Rezultat

Successful browser run (IndexedDB access permitted):
{"items":[{"id":1,"label":"final"}],"count":1,"indexedId":1}

If the browser blocks IndexedDB access with a SecurityError, as in the isolated environment:
IndexedDB unavailable: 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