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

CKTIS / JavaScript

IndexedDB: pridávanie, čítanie, mazanie a nahrádzanie záznamov

Pomocou `add()`, `getAll()`, `delete()` a `put()` pracuješ so záznamami podľa primárneho kľúča. Úspech jednej požiadavky ešte neznamená potvrdenie transakcie.

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

Syntax

store.add(value)
store.add(value, key)
store.getAll()
store.getAll(query)
store.getAll(query, count)
store.getAll(options)
store.delete(keyOrRange)
store.put(value)
store.put(value, key)

Metódy add(), getAll(), delete() a put() patria do rozhrania IDBObjectStore v IndexedDB, nie do ECMAScriptu. Objektové úložisko získaš z transakcie. Prístup k údajom sa riadi pravidlom rovnakého pôvodu (schéma, hostiteľ a port); podpora závisí od behového prostredia.

add(value) iba vkladá: ak primárny kľúč už existuje, požiadavka zlyhá s chybou ConstraintError. put(value) vloží alebo nahradí celú hodnotu pod daným kľúčom; polia nezlučuje. Ak je kľúč súčasťou hodnoty, druhý argument vynechaj: keyPath určuje, kde kľúč nájsť. Pri externom kľúči odovzdaj key ako druhý argument, ak ho nemá prideliť zapnutý generátor kľúčov. Obe metódy uložia štruktúrovanú kópiu hodnoty a pri úspechu sprístupnia kľúč v request.result. Hodnota, ktorá sa nedá klonovať, napríklad funkcia, vyvolá synchrónnu chybu DataCloneError.

getAll() sprístupní v request.result pole klonovaných hodnôt bez osobitne pripojených kľúčov; ak nič nezodpovedá, výsledok je []. Predvolené poradie je vzostupné podľa primárneho kľúča, nie podľa poradia vloženia. Pomocou getAll(query, count) vyberieš kľúč alebo IDBKeyRange a kladným count obmedzíš počet výsledkov. Tvar getAll({ query, count, direction }) umožňuje určiť aj smer, napríklad "prev" pre zostupné poradie; over jeho podporu v cieľových prehliadačoch.

delete(keyOrRange) odstráni záznam podľa primárneho kľúča alebo všetky záznamy v rozsahu IDBKeyRange. Výsledkom úspešnej požiadavky je undefined, aj keď nič nezodpovedalo. Táto metóda nie je operátor JavaScriptu delete; na vyprázdnenie úložiska použi clear().

Všetky štyri metódy okamžite vracajú IDBRequest, nie Promise. Na čítanie stačí readonly; bežné zápisy vyžadujú readwrite. Požiadavky zadávaj, kým je transakcia aktívna, napríklad hneď po jej vytvorení alebo v obsluhe udalosti požiadavky, nie až po čakaní na odpoveď zo siete. Chyba požiadavky predvolene preruší transakciu a vráti jej zmeny späť. success sa týka jednej požiadavky; complete potvrdzuje úspešné potvrdenie celej transakcie.

Príklady

void (async () => {
  const { indexedDB, crypto } = globalThis;
  if (!indexedDB || typeof crypto?.randomUUID !== 'function') {
    throw new Error('Run this example on an HTTPS page in a browser with IndexedDB and crypto.randomUUID() available.');
  }

  const name = `cktis-idb-${crypto.randomUUID()}`;
  const open = indexedDB.open(name, 1);
  open.onupgradeneeded = () => {
    open.result.createObjectStore('tasks', { keyPath: 'id' });
  };
  const db = await new Promise((resolve, reject) => {
    open.onsuccess = () => resolve(open.result);
    open.onerror = () => reject(open.error);
  });

  try {
    const tx = db.transaction('tasks', 'readwrite');
    const store = tx.objectStore('tasks');
    store.add({ id: 2, title: 'Draft', tag: 'temporary' });
    store.add({ id: 1, title: 'Remove me' });
    const before = store.getAll();
    store.put({ id: 2, title: 'Published' });
    store.delete(1);
    const after = store.getAll();

    await new Promise((resolve, reject) => {
      tx.oncomplete = () => resolve();
      tx.onabort = () => reject(tx.error ?? new Error('Transaction aborted'));
    });
    console.log(JSON.stringify(before.result));
    console.log(JSON.stringify(after.result));
  } finally {
    db.close();
    const cleanup = indexedDB.deleteDatabase(name);
    await new Promise((resolve, reject) => {
      cleanup.onsuccess = () => resolve();
      cleanup.onerror = () => reject(cleanup.error);
    });
  }
})().catch((error) => console.error(error));

Výsledok

[{"id":1,"title":"Remove me"},{"id":2,"title":"Draft","tag":"temporary"}]
[{"id":2,"title":"Published"}]

Spusť kód vo vývojárskej konzole stránky HTTPS, kde sú dostupné IndexedDB a `crypto.randomUUID()` a je povolené ukladanie údajov. Po potvrdení transakcie prvý riadok ukáže oba záznamy v poradí podľa kľúčov. Druhý ukáže, že `put()` nezachoval pole `tag` a `delete()` odstránil záznam s kľúčom `1`. Kód zatvorí pripojenie a vyžiada odstránenie dočasnej databázy.

Súvisiace lekcie

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

Zdroje