Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

IDBRequest: rezultat i pogreška zahtjeva

Saznajte kada čitati `result` i `error` u IndexedDB-u te kako razlikovati uspjeh pojedinačnog zahtjeva od potvrde transakcije.

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

Sintaksa

request.readyState; // "pending" or "done"
request.result;     // operation-specific value on success; undefined on failure
request.error;      // null on success; DOMException on failure
// Reading result or error while readyState is "pending" throws InvalidStateError.

result i error dva su svojstva instance IDBRequest koja se mogu samo čitati. Zahtjev u IndexedDB-u predstavlja asinkronu operaciju. Nije Promise, pa await request ne čeka dovršetak operacije. IndexedDB je API web-platforme, nije dio ECMAScripta 2024 i njegova dostupnost ovisi o izvršnom okruženju.

Dok je request.readyState jednak "pending", čitanje bilo kojeg od tih svojstava izaziva iznimku DOMException s nazivom InvalidStateError. Stanje "done" samo po sebi ne znači uspjeh. Rezultat se obično čita u funkciji koja obrađuje događaj success. Iznimka: u obradi događaja upgradeneeded zahtjeva indexedDB.open() svojstvo result već je dostupno za izmjenu sheme, iako završni događaj success još nije nastupio.

Pri događaju success, error je null, a result ovisi o operaciji: open() daje vezu IDBDatabase, add() daje ključ spremljenog zapisa, a get() može dati undefined ako ključu ne odgovara nijedan zapis. Pri događaju error, result je undefined, a error sadrži DOMException. Provjerite request.error.name kako biste prepoznali pogrešku kao što je ConstraintError. Sama vrijednost undefined ne znači neuspjeh. try...catch oko poziva API-ja hvata sinkrone iznimke, ali ne i pogreške koje se kasnije prijave događajem error.

Uspješan zahtjev za zapisivanje ne znači da je transakcija potvrđena. Osluškujte complete za potvrdu transakcije, a abort za otkrivanje poništavanja promjena. Pogreška zahtjeva unutar transakcije po zadanom je prekida. Ako je pogreška očekivana i može se sigurno obraditi, pozovite event.preventDefault() pri obradi događaja error tog zahtjeva. Time sprječavate zadani prekid transakcije, ali zahtjev ostaje neuspješan.

Primjeri

<!doctype html>
<meta charset="utf-8">
<title>IDBRequest result and error</title>
<script>
  (() => {
    const { indexedDB, crypto } = window;
    const name = `cktis-idbrequest-${crypto.randomUUID()}`;
    const open = indexedDB.open(name, 1);
    open.onupgradeneeded = () => open.result.createObjectStore("items");
    open.onerror = () => console.error("open:", open.error.name);

    open.onsuccess = () => {
      const db = open.result;
      const tx = db.transaction("items", "readwrite");
      const store = tx.objectStore("items");
      const cleanup = () => {
        db.close();
        const removal = indexedDB.deleteDatabase(name);
        removal.onerror = () => console.error("cleanup:", removal.error.name);
      };
      tx.oncomplete = () => {
        console.log("transaction: complete");
        cleanup();
      };
      tx.onabort = () => {
        console.error("transaction: abort", tx.error?.name);
        cleanup();
      };

      const first = store.add("first", 1);
      first.onsuccess = () => {
        console.log(`first: result=${first.result}, error=${first.error}`);
        const second = store.add("second", 1);
        second.onerror = (event) => {
          if (second.error.name === "ConstraintError") event.preventDefault();
          console.log(`second: result=${second.result}, error=${second.error.name}`);
        };
      };
    };
  })();
</script>

Rezultat

first: result=1, error=null
second: result=undefined, error=ConstraintError
transaction: complete

Otvorite primjer kao HTML stranicu preko HTTPS-a na kojoj su dostupni IndexedDB i `crypto.randomUUID()`. Provjerite poruke u konzoli preglednika. Drugi poziv `add()` pokušava upotrijebiti isti ključ. Obrada pogreške sprječava zadani prekid samo za očekivani `ConstraintError`, pa se prvi upis može potvrditi. Nakon završetka transakcije kôd zatvara vezu i traži brisanje testne baze podataka.

Povezane lekcije

  • JavaScript · Lekcija 20 · Srednje · Verzija: 3
  • JavaScript · Lekcija 21 · Srednje · Verzija: 3

Izvori