Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

IDBTransaction — transakcija IndexedDB

IDBTransaction združuje operacije IndexedDB, tako da se spremembe potrdijo skupaj ali razveljavijo. Spoznajte obseg shramb, dogodek complete, preklic z abort() in lastnost error.

Različica: 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 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 atomsko združuje operacije IndexedDB: vse spremembe se potrdijo ali razveljavijo. db.transaction() določi obseg objektnih shramb in način: readonly za branje, readwrite tudi za pisanje. To je Web API, ne del ECMAScript; Node 24 ne potrjuje njegove razpoložljivosti v brskalniku. V ciljnem okolju preverite, ali je na voljo indexedDB.

IDBTransaction.objectStore(name) vrne sklic na shrambo znotraj obsega transakcije; drugo ime povzroči NotFoundError. Operacije dodajajte, dokler je transakcija aktivna, običajno takoj po njenem ustvarjanju ali v obravnavalnikih dogodkov njenih zahtev. Čakanje na nepovezano asinhrono delo lahko omogoči samodejni zaključek transakcije.

IDBTransaction.complete označuje dogodek complete, ki ga obravnavate z oncomplete ali addEventListener; ni metoda. Potrjuje zaključek, vendar ga success posamezne zahteve ne zagotavlja. IDBTransaction.abort() razveljavi spremembe in sproži dogodek abort; klic med potrjevanjem ali po zaključku povzroči InvalidStateError.

IDBTransaction.error je lastnost, ki vsebuje DOMException, ki opisuje napako, ali null, tudi po ročnem klicu abort(). Ne zamenjujte je z dogodkom error: napake zahtev se lahko širijo do transakcije.

Če se podatkovna zbirka odpre in operacije potekajo po načrtu, koda zapiše 42 pod ključem "answer" in počaka na dogodek complete, ki potrdi zapis. Nato prekliče ločeno transakcijo, ki zapiše 99, prebere ohranjeno vrednost 42 in jo izpiše. Pri prikazanem izvajanju odpiranje podatkovne zbirke ne uspe zaradi napake SecurityError, še preden se začne katera koli transakcija. Izpis Transaction not started: SecurityError zato ne prikazuje ne zapisa ne potrditve transakcije.

Primeri

(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));
    }
  }
})();

Rezultat

Transaction not started: SecurityError

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri