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

CKTIS / JavaScript

IndexedDB: vytvorenie indexu, vkladanie, počítanie a čítanie záznamov

Vytvorte sekundárny index, vkladajte záznamy bez prepísania a vyhľadávajte podľa primárneho kľúča alebo kľúča indexu.

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

Syntax

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 predstavuje úložisko objektov viazané na transakciu. Každý záznam má primárny kľúč a hodnotu. IndexedDB je webové API, nie súčasť ECMAScriptu; prístup sa riadi zásadou rovnakého pôvodu.

createIndex(name, keyPath, options) ihneď vráti IDBIndex, ale možno ho volať len v aktívnej transakcii versionchange, zvyčajne v upgradeneeded. Cesta ku kľúču určuje, odkiaľ sa získa kľúč indexu; nepridáva pole do záznamu. unique: true zakazuje duplicitné kľúče indexu a multiEntry: true indexuje platné prvky poľa samostatne. Obe voľby majú predvolenú hodnotu false. multiEntry: true nemožno kombinovať so zloženou cestou ku kľúču zadanou ako pole ciest.

add(value, key) uloží štruktúrovanú kópiu a nový kľúč sprístupní v request.result. Ak je kľúč súčasťou hodnoty, druhý argument vynechajte; pri samostatnom kľúči bez generátora ho zadajte. Duplicitný primárny kľúč alebo porušenie jedinečnosti indexu spôsobí chybu požiadavky ConstraintError. Na vloženie alebo nahradenie podľa primárneho kľúča použite put().

count(query) poskytne číslo a getAll(query, count) pole kópií hodnôt, prázdne, ak nič nezodpovedá filtru. Obe metódy prijímajú primárny kľúč alebo IDBKeyRange a bez filtra zahŕňajú celé úložisko. Kladný count obmedzuje počet hodnôt z getAll(). Predvolené poradie je vzostupné podľa primárneho kľúča. Novší tvar getAll({ query, count, direction }) umožňuje napríklad "prev"; overte podporu v cieľovom prehliadači.

index(name) ihneď vráti existujúci IDBIndex z tej istej transakcie. Neznámy názov vyvolá NotFoundError; záleží na veľkosti písmen. store.getAll("sci-fi") hľadá podľa primárneho kľúča, zatiaľ čo store.index("byGenre").getAll("sci-fi") vráti hodnoty záznamov podľa kľúča indexu.

add(), count() a getAll() vracajú IDBRequest, nie Promise. Čítajte result po success a ošetrite error. V bežnej transakcii zápis vyžaduje režim readwrite. Zaraďujte požiadavky, kým je transakcia aktívna: čakanie na inú asynchrónnu operáciu jej môže umožniť skončiť. Úspech požiadavky ešte nepotvrdzuje transakciu; počkajte na jej udalosť complete.

Príklady

<!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>

Výsledok

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

Sprístupnite tento dokument HTML cez HTTPS, otvorte ho v prehliadači a pozrite si vývojársku konzolu. Príklad vytvorí samostatnú dočasnú databázu a potom ju odstráni. Vloží tri knihy mimo poradia primárnych kľúčov a po potvrdení transakcie vypíše všetky názvy podľa `id` aj názvy vybrané indexom žánru.

Súvisiace lekcie

  • JavaScript · Lekcia 21 · Stredne pokročilá · Verzia: 3

Zdroje