WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

IDBRequest: Ergebnis und Fehler einer Anfrage

Lerne, wann du `result` und `error` in IndexedDB lesen kannst und wie du den Erfolg einer einzelnen Anfrage vom Commit der Transaktion unterscheidest.

Version: 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 und error sind zwei schreibgeschützte Eigenschaften einer IDBRequest-Instanz. Eine IndexedDB-Anfrage steht für einen asynchronen Vorgang. Sie ist kein Promise, daher wartet await request nicht auf das Ende des Vorgangs. IndexedDB ist eine Webplattform-API und kein Bestandteil von ECMAScript 2024; die Verfügbarkeit hängt von der Laufzeitumgebung ab.

Solange request.readyState den Wert "pending" hat, wirft das Lesen beider Eigenschaften jeweils eine DOMException namens InvalidStateError. Der Zustand "done" bedeutet nicht automatisch Erfolg. Lies das Ergebnis normalerweise im success-Handler. Eine Ausnahme: Im upgradeneeded-Handler einer indexedDB.open()-Anfrage steht result bereits für Schemaänderungen zur Verfügung, obwohl das abschließende success-Ereignis noch nicht ausgelöst wurde.

Bei success ist error gleich null, und result hängt vom Vorgang ab: open() liefert eine IDBDatabase-Verbindung, add() den Schlüssel des gespeicherten Datensatzes, und get() kann undefined liefern, wenn kein Datensatz zum Schlüssel passt. Bei error ist result gleich undefined, und error enthält eine DOMException. Prüfe request.error.name, um beispielsweise einen ConstraintError zu erkennen. undefined allein bedeutet keinen Fehler. Ein try...catch um den API-Aufruf fängt synchrone Ausnahmen ab, nicht aber Fehler, die später per error-Ereignis gemeldet werden.

Eine erfolgreiche Schreibanfrage bestätigt noch keinen Commit. Achte auf complete, um den Commit zu bestätigen, und auf abort, um eine Rückabwicklung zu erkennen. Ein Anfragefehler innerhalb einer Transaktion bricht diese standardmäßig ab. Kannst du einen erwarteten Fehler sicher behandeln, verhindert event.preventDefault() im error-Handler der Anfrage diesen standardmäßigen Abbruch. Die Anfrage selbst bleibt fehlgeschlagen.

Beispiele

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

Ergebnis

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

Öffne das Beispiel als HTML-Seite über HTTPS, auf der IndexedDB und `crypto.randomUUID()` verfügbar sind. Prüfe die Meldungen in der Browserkonsole. Das zweite `add()` versucht, denselben Schlüssel zu verwenden. Der Handler verhindert den standardmäßigen Abbruch nur beim erwarteten `ConstraintError`, sodass der erste Schreibvorgang festgeschrieben werden kann. Nach Ende der Transaktion schließt der Code die Verbindung und beantragt das Löschen der Testdatenbank.

Zugehörige Lektionen

  • JavaScript · Lektion 20 · Mittlere Stufe · Version: 3
  • JavaScript · Lektion 21 · Mittlere Stufe · Version: 3

Quellen