WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

IDBRequest — Ergebnis einer IndexedDB-Operation

IDBRequest stellt das Ergebnis oder den Fehler einer asynchronen IndexedDB-Operation über Ereignisse bereit. Eine erfolgreiche Anfrage bedeutet noch nicht, dass die gesamte Transaktion abgeschlossen ist.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

request.result
request.error
request.onsuccess = (event) => { /* read request.result */ };
request.onerror = (event) => { /* read request.error */ };

IDBRequest ist ein EventTarget-Objekt, das von IndexedDB-Operationen wie get() zurückgegeben wird. Es ist kein Promise: await request allein wartet nicht auf das Ergebnis. Es gehört zu den Web APIs, nicht zu ECMAScript; die Verfügbarkeit von Node 24 beweist nicht, dass die API im Browser verfügbar ist.

IDBRequest.result enthält ein operationsabhängiges Ergebnis; nach einem Fehler gibt es undefined zurück. IDBRequest.error gibt nach einem Fehler eine DOMException und nach Erfolg null zurück. Das Lesen einer der beiden Eigenschaften, während readyState === "pending" gilt, löst InvalidStateError aus. Ein fehlender Datensatz bei get() ist ein Erfolg mit dem Ergebnis undefined, kein Fehler.

IDBRequest.onsuccess behandelt das Ereignis success, und IDBRequest.onerror behandelt error. Ein Anfragefehler bricht die zugehörige Transaktion standardmäßig ab; das bloße Zuweisen eines Handlers ändert daran nichts. Der Erfolg einer Anfrage garantiert nicht den Commit: Beobachte auch die Ereignisse complete und abort der Transaktion.

Das Beispiel öffnet eine Datenbank mit IDBOpenDBRequest, einem Untertyp von IDBRequest. Schreib- und Lesevorgang werden in derselben Transaktion in die Warteschlange gestellt. Wenn get() erfolgreich ist, gibt der zugehörige onsuccess-Handler request.result aus, bevor die Transaktion das Ereignis complete auslöst, sofern es dazu kommt. Die gezeigte Ausgabe IndexedDB unavailable: SecurityError stammt aus einem Fehlerpfad, auf dem der Lesevorgang nicht erreicht wird.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IDBRequest: operation success and transaction completion</title>
</head>
<body>
  <h1>Observing an IndexedDB request</h1>
  <script>
    (() => {
      const name = 'cktis-request-' + crypto.getRandomValues(new Uint32Array(4)).join('-');
      const report = error => console.log(error.name === 'SecurityError'
        ? 'IndexedDB unavailable: SecurityError' : `IndexedDB error: ${error.name}`);
      let factory, opening;
      try {
        factory = window.indexedDB;
        if (!factory) {
          console.log('IndexedDB unavailable: API missing');
          return;
        }
        opening = factory.open(name, 1);
      } catch (error) {
        report(error);
        return;
      }
      let created = false;
      opening.onerror = () => report(opening.error);
      opening.onupgradeneeded = () => {
        created = true;
        opening.result.createObjectStore('values');
      };
      opening.onsuccess = () => {
        const db = opening.result;
        if (!created) {
          db.close();
          console.log('Fixture name already in use');
          return;
        }
        const tx = db.transaction('values', 'readwrite');
        const store = tx.objectStore('values');
        store.put('circle', 'shape');
        const request = store.get('shape');
        const cleanup = () => {
          db.close();
          factory.deleteDatabase(name);
        };
        console.log(`get before events: ${request.readyState}`);
        request.onsuccess = () => {
          console.log(`get success: ${request.readyState}, value: ${request.result}`);
        };
        request.onerror = () => console.log(`get error: ${request.error.name}`);
        tx.oncomplete = event => {
          console.log(`transaction: ${event.type}`);
          cleanup();
        };
        tx.onabort = event => {
          console.log(`transaction: ${event.type}`);
          cleanup();
        };
      };
    })();
  </script>
</body>
</html>

Ergebnis

IndexedDB unavailable: SecurityError

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen