Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

IDBRequest: výsledek a chyba požadavku

Zjistěte, kdy v IndexedDB číst `result` a `error` a jak odlišit úspěch jednotlivého požadavku od potvrzení celé transakce.

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

Syntaxe

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 jsou dvě vlastnosti instance IDBRequest určené pouze pro čtení. Požadavek IndexedDB představuje asynchronní operaci. Není to Promise, takže await request nečeká na dokončení operace. IndexedDB je rozhraní webové platformy, nikoli součást ECMAScriptu 2024. Jeho dostupnost závisí na běhovém prostředí.

Dokud má request.readyState hodnotu "pending", čtení kterékoli z těchto vlastností vyvolá výjimku DOMException s názvem InvalidStateError. Stav "done" sám o sobě neznamená úspěch. Výsledek obvykle čtěte v obsluze události success. Výjimka: v obsluze události upgradeneeded požadavku indexedDB.open() je result už dostupný pro změny schématu, přestože konečná událost success ještě nenastala.

Při success má error hodnotu null a result závisí na operaci: open() poskytne připojení IDBDatabase, add() vrátí klíč uloženého záznamu a get() může vrátit undefined, pokud klíči neodpovídá žádný záznam. Při error má result hodnotu undefined a error obsahuje DOMException. Pomocí request.error.name rozpoznáte například ConstraintError. Samotné undefined neznamená selhání. try...catch okolo volání API zachytí synchronní výjimky, nikoli selhání později oznámená událostí error.

Úspěšný požadavek na zápis ještě neznamená, že byla transakce potvrzena. Událost complete potvrzuje dokončení transakce, zatímco abort signalizuje její zrušení a vrácení změn. Chyba požadavku uvnitř transakce ji ve výchozím nastavení zruší. Pokud očekávanou chybu dokážete bezpečně zpracovat, zavolejte event.preventDefault() v obsluze error požadavku. Zabráníte tím výchozímu zrušení transakce, ale požadavek zůstane neúspěšný.

Pří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ýsledek

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

Otevřete příklad jako stránku HTML přes HTTPS, na níž jsou dostupné IndexedDB i `crypto.randomUUID()`. Zprávy najdete v konzoli prohlížeče. Druhé volání `add()` se pokusí použít stejný klíč. Obsluha zabrání výchozímu zrušení transakce pouze u očekávané chyby `ConstraintError`, takže první zápis lze potvrdit. Po skončení transakce kód uzavře připojení a požádá o odstranění testovací databáze.

Související lekce

  • JavaScript · Lekce 20 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 21 · Středně pokročilá · Verze: 3

Zdroje