Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

IDBRequest: wynik i błąd żądania

Dowiedz się, kiedy odczytywać `result` i `error` w IndexedDB oraz jak odróżnić powodzenie pojedynczego żądania od zatwierdzenia transakcji.

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

Składnia

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 i error to dwie właściwości tylko do odczytu na obiekcie IDBRequest. Żądanie IndexedDB reprezentuje operację asynchroniczną. Nie jest obietnicą (Promise), więc await request nie czeka na jej wykonanie. IndexedDB jest interfejsem API platformy webowej, a nie częścią ECMAScript 2024; jego dostępność zależy od środowiska uruchomieniowego.

Gdy request.readyState ma wartość "pending", odczyt którejkolwiek z tych właściwości zgłasza DOMException o nazwie InvalidStateError. Stan "done" sam w sobie nie oznacza powodzenia. Wynik zwykle odczytuje się w obsłudze zdarzenia success. Wyjątek: w obsłudze upgradeneeded żądania indexedDB.open() można już odczytać result, aby zmienić schemat, choć końcowe zdarzenie success jeszcze nie nastąpiło.

Po zdarzeniu success właściwość error ma wartość null, a result zależy od operacji: open() udostępnia połączenie IDBDatabase, add() zwraca klucz zapisanego rekordu, a get() może zwrócić undefined, gdy nie ma rekordu o podanym kluczu. Po zdarzeniu error właściwość result ma wartość undefined, a error zawiera DOMException. Sprawdzaj request.error.name, żeby rozpoznać np. ConstraintError. Samo undefined nie świadczy o błędzie. try...catch wokół wywołania metody przechwytuje wyjątki synchroniczne, ale nie późniejsze błędy zgłaszane zdarzeniem error.

Powodzenie żądania zapisu nie oznacza jeszcze zatwierdzenia transakcji. Nasłuchuj complete, żeby potwierdzić zatwierdzenie, oraz abort, żeby wykryć wycofanie. Błąd żądania w transakcji domyślnie ją przerywa. Jeśli błąd jest oczekiwany i można go bezpiecznie obsłużyć, event.preventDefault() w obsłudze zdarzenia error zapobiega temu domyślnemu przerwaniu, ale nie zmienia nieudanego żądania w udane.

Przykłady

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

Wynik

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

Otwórz przykład jako stronę HTML udostępnianą przez HTTPS, na której dostępne są IndexedDB i `crypto.randomUUID()`. Sprawdź komunikaty w konsoli przeglądarki. Drugi `add()` próbuje użyć tego samego klucza. Obsługa błędu anuluje tylko domyślne przerwanie po oczekiwanym `ConstraintError`, więc pierwszy zapis może zostać zatwierdzony. Po zakończeniu transakcji kod zamyka połączenie i zleca usunięcie bazy testowej.

Powiązane lekcje

  • JavaScript · Lekcja 20 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 21 · Średniozaawansowany · Wersja: 3

Źródła