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

CKTIS / JavaScript

IDBRequest: výsledok a chyba požiadavky

Zistite, kedy v IndexedDB čítať `result` a `error` a ako odlíšiť úspech jednotlivej požiadavky od potvrdenia celej transakcie.

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

Syntax

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 a error sú dve vlastnosti inštancie IDBRequest určené len na čítanie. Požiadavka IndexedDB predstavuje asynchrónnu operáciu. Nie je to Promise, takže await request nečaká na dokončenie operácie. IndexedDB je API webovej platformy, nie súčasť ECMAScriptu 2024. Jeho dostupnosť závisí od prostredia, v ktorom kód beží.

Kým má request.readyState hodnotu "pending", čítanie ktorejkoľvek z týchto vlastností vyvolá výnimku DOMException s názvom InvalidStateError. Stav "done" sám osebe neznamená úspech. Výsledok zvyčajne čítajte v obsluhe udalosti success. Výnimka: v obsluhe udalosti upgradeneeded požiadavky indexedDB.open() je result už dostupný na zmenu schémy, hoci záverečná udalosť success ešte nenastala.

Pri success má error hodnotu null a result závisí od operácie: open() poskytne pripojenie IDBDatabase, add() vráti kľúč uloženého záznamu a get() môže vrátiť undefined, ak kľúču nezodpovedá žiadny záznam. Pri error má result hodnotu undefined a error obsahuje DOMException. Pomocou request.error.name rozpoznáte napríklad ConstraintError. Samotné undefined neznamená zlyhanie. try...catch okolo volania API zachytí synchrónne výnimky, nie zlyhania neskôr oznámené udalosťou error.

Úspešná požiadavka na zápis ešte neznamená, že bola transakcia potvrdená. Udalosť complete potvrdzuje dokončenie transakcie, kým abort oznamuje jej zrušenie a vrátenie zmien. Chyba požiadavky v rámci transakcie ju predvolene zruší. Ak očakávanú chybu dokážete bezpečne spracovať, zavolajte event.preventDefault() v obsluhe udalosti error danej požiadavky. Zabránite tým predvolenému zrušeniu transakcie, no požiadavka zostane neúspešná.

Príklady

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

Výsledok

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

Otvorte príklad ako stránku HTML cez HTTPS, na ktorej sú dostupné IndexedDB aj `crypto.randomUUID()`. Správy nájdete v konzole prehliadača. Druhé volanie `add()` sa pokúsi použiť rovnaký kľúč. Obsluha zabráni predvolenému zrušeniu transakcie iba pri očakávanej chybe `ConstraintError`, takže prvý zápis sa môže potvrdiť. Po skončení transakcie kód zatvorí pripojenie a požiada o odstránenie testovacej databázy.

Súvisiace lekcie

  • JavaScript · Lekcia 20 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 21 · Stredne pokročilá · Verzia: 3

Zdroje