База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

IDBRequest: резултат, грешка и обработчици на събития

Прочети `result` при успех на заявка към IndexedDB и `error` при неуспех. Успехът на отделна заявка не означава, че транзакцията е потвърдена.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

// 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 е обект на заявка към IndexedDB, а не обещание (Promise). IndexedDB е уеб API, а не част от ECMAScript 2024; наличността му зависи от средата за изпълнение. Докато readyState е "pending", прочитането на което и да е от свойствата само за четене result и error хвърля DOMException с име InvalidStateError. Състоянието "done" позволява да прочетеш тези свойства, но не означава, че заявката е успешна. Заявка IDBOpenDBRequest може да е в състояние "done" още по време на upgradeneeded, преди крайното събитие success или error.

Присвои функции на request.onsuccess и request.onerror, за да обработваш съответно success и error. Повторното присвояване заменя предишния обработчик; с addEventListener() можеш да добавяш отделни слушатели, като използваш името на събитието без on. При успех прочети request.result: стойността зависи от операцията. Например add() предоставя ключа чрез result, а get() може да завърши успешно с undefined, ако ключът липсва. При успех request.error е null; при неуспех съдържа DOMException, а request.result е undefined. Конструкцията try...catch около извикването може да прихване синхронно изключение от него, но не и по-късен неуспех на заявката.

Събитието success не се разпространява нагоре и не може да бъде отменено. При заявка в транзакция error се разпространява нагоре и по подразбиране прекратява транзакцията. Извикай event.preventDefault() в обработчика на очаквана грешка, след която може да се продължи, за да предотвратиш това прекратяване по подразбиране. Заявката остава неуспешна, а събитието продължава да се разпространява.

Успешната заявка за запис не означава, че транзакцията е потвърдена. Подай следващите заявки, докато транзакцията е активна, например направо в обработчик на събитие на заявка. На ниво транзакция слушай за complete, за да установиш потвърждаването, и за abort, за да установиш отмяната на промените.

Примери

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

Резултат

success: 1
error: ConstraintError
transaction: complete

Запази примера като HTML файл и го предостави през HTTPS. Отвори страницата в браузър, в който са налични IndexedDB и `crypto.randomUUID()`, и провери изхода в конзолата за разработчици. Първото `add()` предоставя ключа `1` чрез `result`; второто завършва с `ConstraintError`. `preventDefault()` не позволява тази грешка да прекрати транзакцията, така че тя може да излъчи `complete`. След края на транзакцията кодът затваря връзката и заявява изтриване на базата данни, създадена за това изпълнение.

Свързани уроци

  • JavaScript · Урок 31 · Напреднало · Версия: 4

Източници