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

CKTIS / JavaScript

IDBTransaction — transakcia IndexedDB

IDBTransaction združuje operácie IndexedDB, takže sa zmeny potvrdia spoločne alebo vrátia späť. Zistite viac o rozsahu úložísk, udalosti complete, zrušení pomocou abort() a vlastnosti error.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const tx = db.transaction("items", "readwrite");
const store = tx.objectStore("items");
tx.addEventListener("complete", () => {});
tx.addEventListener("abort", () => { console.error(tx.error); });
// To cancel before committing: tx.abort();

IDBTransaction atomicky združuje operácie IndexedDB: všetky zmeny sa potvrdia alebo vrátia späť. db.transaction() určuje rozsah objektových úložísk a režim: readonly na čítanie, readwrite aj na zápis. Ide o Web API, nie o súčasť ECMAScriptu; Node 24 nepotvrdzuje jeho dostupnosť v prehliadači. V cieľovom prostredí overte, či je k dispozícii indexedDB.

IDBTransaction.objectStore(name) vracia odkaz na úložisko v rozsahu transakcie; iný názov spôsobí NotFoundError. Zadávajte operácie, kým je transakcia aktívna, zvyčajne hneď po jej vytvorení alebo v obslužných rutinách udalostí jej požiadaviek. Čakanie na nesúvisiacu asynchrónnu prácu môže umožniť automatické dokončenie transakcie.

IDBTransaction.complete označuje udalosť complete, ktorú možno obsluhovať pomocou oncomplete alebo addEventListener; nejde o metódu. Potvrdzuje dokončenie, ale success jednotlivej požiadavky ho nezaručuje. IDBTransaction.abort() vráti zmeny späť a vyvolá udalosť abort; volanie počas potvrdzovania alebo po dokončení spôsobí InvalidStateError.

IDBTransaction.error je vlastnosť obsahujúca DOMException opisujúcu zlyhanie alebo null, a to aj po manuálnom abort(). Nezamieňajte si ju s udalosťou error: chyby požiadaviek sa môžu šíriť až k transakcii.

Ak sa databáza otvorí a operácie prebehnú podľa očakávania, kód zapíše 42 pod kľúčom "answer" a počká na udalosť complete, ktorá potvrdí zápis. Potom zruší samostatnú transakciu, ktorá zapisuje 99, načíta zachovanú hodnotu 42 a vypíše ju. V zobrazenom behu otvorenie databázy zlyhá s chybou SecurityError ešte pred začiatkom akejkoľvek transakcie. Výstup Transaction not started: SecurityError teda neukazuje zápis ani potvrdenie transakcie.

Príklady

(async () => {
  const name = `cktis-transaction-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
  const result = request => new Promise((resolve, reject) => {
    request.onsuccess = () => resolve(request.result);
    request.onerror = () => reject(request.error);
  });
  const completed = tx => new Promise((resolve, reject) => {
    tx.oncomplete = resolve;
    tx.onabort = () => reject(tx.error ?? new DOMException('Transaction aborted', 'AbortError'));
  });

  let db;
  try {
    const open = indexedDB.open(name, 1);
    open.onupgradeneeded = () => open.result.createObjectStore('items');
    db = await result(open);

    const write = db.transaction('items', 'readwrite');
    const scope = Array.from(write.objectStoreNames).join(', ');
    const committed = completed(write);
    write.objectStore('items').put(42, 'answer');
    await committed;

    const undo = db.transaction('items', 'readwrite');
    const aborted = new Promise((resolve, reject) => {
      undo.onabort = () => resolve(undo.error);
      undo.oncomplete = () => reject(new Error('Expected an abort'));
    });
    const update = undo.objectStore('items').put(99, 'answer');
    update.onsuccess = () => undo.abort();
    const abortError = await aborted;

    const read = db.transaction('items', 'readonly');
    const [stored] = await Promise.all([
      result(read.objectStore('items').get('answer')),
      completed(read)
    ]);
    console.log(`Scope: ${scope}; stored after rollback: ${stored}; abort error: ${abortError?.name ?? 'null'}`);
  } catch (error) {
    if (!db && error.name === 'SecurityError') {
      console.log(`Transaction not started: ${error.name}`);
    } else {
      console.log(`Transaction example failed: ${error.name}`);
    }
  } finally {
    if (db) {
      db.close();
      await result(indexedDB.deleteDatabase(name));
    }
  }
})();

Výsledok

Transaction not started: SecurityError

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje