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

CKTIS / JavaScript

IDBRequest: rezultat, napaka in obravnava dogodkov

Po uspešni zahtevi IndexedDB preberi `result`, po neuspešni pa `error`. Uspeh posamezne zahteve še ne pomeni, da je bila potrjena celotna transakcija.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

// Read-only members; do not read either while readyState is "pending".
// request.result
// request.error

request.onsuccess = (event) => { /* read request.result */ };
request.onerror = (event) => { /* read request.error */ };

// Alternative registration; event names omit the "on" prefix.
request.addEventListener("success", handleSuccess);
request.addEventListener("error", handleError);

IDBRequest je objekt zahteve IndexedDB, ne obljuba (Promise). IndexedDB je spletni API in ni del ECMAScript 2024; njegova dostopnost je odvisna od izvajalnega okolja. Dokler ima readyState vrednost "pending", branje katere koli od lastnosti samo za branje, result ali error, sproži izjemo DOMException z imenom InvalidStateError. V stanju "done" lahko ti lastnosti prebereš, vendar to ne pomeni, da je zahteva uspela. Zahteva IDBOpenDBRequest je lahko v stanju "done" že med dogodkom upgradeneeded, še pred končnim dogodkom success ali error.

Lastnostma request.onsuccess in request.onerror dodeli funkciji za obravnavo dogodkov success oziroma error. Nova dodelitev nadomesti prejšnjo funkcijo; z addEventListener() lahko dodaš ločene poslušalce z imenom dogodka brez on. Ob uspehu preberi request.result: vrednost je odvisna od operacije. Tako add() prek result vrne ključ, get() pa lahko uspe z vrednostjo undefined, če ključa ni. Ob uspehu je request.error enak null; ob neuspehu vsebuje DOMException, request.result pa ima vrednost undefined. Blok try...catch okrog klica lahko prestreže sinhrono izjemo tega klica, ne pa poznejšega neuspeha zahteve.

Dogodek success se ne širi navzgor in ga ni mogoče preklicati. Pri zahtevi znotraj transakcije se error širi navzgor in privzeto povzroči prekinitev transakcije. Pri obravnavi pričakovane napake, po kateri je mogoče nadaljevati, pokliči event.preventDefault(), da preprečiš to privzeto prekinitev. Zahteva s tem ne postane uspešna, dogodek pa se še naprej širi.

Uspešen zapis ne pomeni, da je bila transakcija potrjena. Nove zahteve oddaj, dokler je transakcija aktivna, na primer neposredno v funkciji za obravnavo dogodka zahteve. Na transakciji poslušaj complete za zaznavo potrditve in abort za zaznavo razveljavitve sprememb.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IDBRequest: success and error</title>
</head>
<body>
  <p>Open the browser developer console to see the output.</p>
  <script>
    (() => {
      const name = `cktis-idbrequest-${window.crypto.randomUUID()}`;
      const open = window.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");

        function cleanup() {
          db.close();
          const deletion = window.indexedDB.deleteDatabase(name);
          deletion.onerror = () => console.error("cleanup:", deletion.error.name);
        }

        tx.oncomplete = () => {
          console.log("transaction: complete");
          cleanup();
        };
        tx.onabort = () => {
          console.error("transaction: aborted", tx.error?.name);
          cleanup();
        };

        const first = store.add("first", 1);
        first.onsuccess = () => console.log(`success: ${first.result}`);

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

Rezultat

success: 1
error: ConstraintError
transaction: complete

Primer shrani kot datoteko HTML in ga ponudi prek HTTPS. Stran odpri v brskalniku, kjer sta na voljo IndexedDB in `crypto.randomUUID()`, ter preveri izpis v razvijalski konzoli. Prvi `add()` prek `result` vrne ključ `1`, drugi pa ne uspe zaradi napake `ConstraintError`. `preventDefault()` prepreči, da bi ta napaka prekinila transakcijo, zato se lahko sproži `complete`. Po koncu transakcije koda zapre povezavo in zahteva izbris podatkovne zbirke, ustvarjene za to izvedbo.

Povezane lekcije

  • JavaScript · Lekcija 31 · Napredna · Različica: 4

Viri