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

CKTIS / JavaScript

IDBRequest: výsledok, chyba a obsluha udalostí

Po úspechu požiadavky IndexedDB čítaj `result`, po zlyhaní `error`. Úspech jednej požiadavky ešte neznamená, že bola potvrdená celá transakcia.

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

Syntax

// 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 požiadavky IndexedDB, nie prísľub (Promise). IndexedDB je webové API, nie súčasť ECMAScript 2024; jeho dostupnosť závisí od prostredia vykonávania. Kým má readyState hodnotu "pending", čítanie ktorejkoľvek z vlastností určených iba na čítanie, result alebo error, vyvolá výnimku DOMException s názvom InvalidStateError. V stave "done" sa tieto vlastnosti dajú čítať, ale tento stav neznamená, že požiadavka uspela. Požiadavka IDBOpenDBRequest môže byť v stave "done" už počas udalosti upgradeneeded, ešte pred záverečnou udalosťou success alebo error.

Priraď funkcie do request.onsuccess a request.onerror na obsluhu udalostí success a error v tomto poradí. Nové priradenie nahradí predchádzajúcu obslužnú funkciu; cez addEventListener() môžeš pridať samostatných poslucháčov s názvom udalosti bez on. Pri úspechu čítaj request.result: hodnota závisí od operácie. Napríklad add() poskytne kľúč cez result, kým get() môže uspieť s hodnotou undefined, ak kľúč chýba. Pri úspechu má request.error hodnotu null; pri zlyhaní obsahuje DOMException a request.result má hodnotu undefined. Konštrukcia try...catch okolo volania môže zachytiť jeho synchrónnu výnimku, nie neskoršie zlyhanie požiadavky.

Udalosť success sa nešíri smerom nahor a nedá sa zrušiť. Pri požiadavke v transakcii sa error šíri smerom nahor a predvolene spôsobí prerušenie transakcie. V obsluhe očakávanej chyby, z ktorej sa dá zotaviť, zavolaj event.preventDefault(), aby si tomuto predvolenému prerušeniu zabránil. Požiadavka zostane neúspešná a udalosť sa bude šíriť ďalej.

Úspešná požiadavka na zápis neznamená potvrdenie transakcie. Ďalšie požiadavky zadávaj, kým je transakcia aktívna, napríklad priamo v obsluhe udalosti požiadavky. Na transakcii sleduj complete na zistenie potvrdenia a abort na zistenie vrátenia zmien.

Príklady

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

Výsledok

success: 1
error: ConstraintError
transaction: complete

Ulož príklad ako súbor HTML a sprístupni ho cez HTTPS. Otvor stránku v prehliadači, kde sú dostupné IndexedDB a `crypto.randomUUID()`, a skontroluj výstup vo vývojárskej konzole. Prvé `add()` poskytne kľúč `1` cez `result`; druhé zlyhá s chybou `ConstraintError`. `preventDefault()` zabráni tomu, aby táto chyba prerušila transakciu, takže môže nastať `complete`. Po skončení transakcie kód zatvorí pripojenie a požiada o odstránenie databázy vytvorenej pre toto spustenie.

Súvisiace lekcie

  • JavaScript · Lekcia 31 · Pokročilá · Verzia: 4

Zdroje