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

CKTIS / JavaScript

IDBRequest: rezultat in napaka zahteve

Naučite se, kdaj v IndexedDB prebrati `result` in `error` ter kako ločiti uspeh posamezne zahteve od potrditve transakcije.

Različica: 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 in error sta lastnosti primerka IDBRequest, namenjeni samo branju. Zahteva IndexedDB predstavlja asinhrono operacijo. Ni obljuba (Promise), zato await request ne počaka na konec operacije. IndexedDB je API spletne platforme, ne del ECMAScripta 2024. Razpoložljivost je odvisna od izvajalnega okolja.

Dokler ima request.readyState vrednost "pending", branje katere koli od teh lastnosti sproži izjemo DOMException z imenom InvalidStateError. Stanje "done" samo po sebi ne pomeni uspeha. Rezultat običajno preberete v obravnavalniku dogodka success. Izjema: v obravnavalniku dogodka upgradeneeded zahteve indexedDB.open() je result že na voljo za spreminjanje sheme, čeprav se končni dogodek success še ni sprožil.

Ob dogodku success je vrednost error enaka null, vrednost result pa je odvisna od operacije: open() zagotovi povezavo IDBDatabase, add() vrne ključ shranjenega zapisa, get() pa lahko vrne undefined, če ključu ne ustreza noben zapis. Ob dogodku error je vrednost result enaka undefined, error pa vsebuje DOMException. Z request.error.name prepoznate napako, kot je ConstraintError. Rezultat undefined sam po sebi ne pomeni neuspeha. try...catch okoli klica API-ja prestreže sinhrone izjeme, ne pa napak, ki jih pozneje sporoči dogodek error.

Uspešna zahteva za pisanje še ne pomeni, da je bila transakcija potrjena. Dogodek complete potrdi, da so spremembe uveljavljene, abort pa sporoči, da je bila transakcija preklicana in da so bile spremembe razveljavljene. Napaka zahteve v transakciji privzeto prekine transakcijo. Če lahko pričakovano napako varno obravnavate, kličite event.preventDefault() v obravnavalniku dogodka error te zahteve. S tem preprečite privzeto prekinitev, vendar zahteva ostane neuspešna.

Primeri

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

Odprite primer kot stran HTML prek HTTPS, na kateri sta na voljo IndexedDB in `crypto.randomUUID()`. Sporočila preverite v konzoli brskalnika. Drugi klic `add()` poskuša uporabiti isti ključ. Obravnavalnik prepreči privzeto prekinitev samo pri pričakovani napaki `ConstraintError`, zato se prvi zapis lahko potrdi. Ko se transakcija konča, koda zapre povezavo in zahteva izbris preskusne podatkovne zbirke.

Povezane lekcije

  • JavaScript · Lekcija 20 · Srednja · Različica: 3
  • JavaScript · Lekcija 21 · Srednja · Različica: 3

Viri