WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

IndexedDB: Cursor mit `value` lesen und mit `continue()` weiterschalten

Lies den aktuellen IndexedDB-Datensatz über einen Cursor und fordere den nächsten Datensatz an oder springe mithilfe eines Schlüssels weiter.

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

Syntax

cursor.value           // Read-only property of IDBCursorWithValue
cursor.continue()      // Request the next eligible position; returns undefined
cursor.continue(key)   // Request the next eligible position at or beyond key in the cursor's direction; returns undefined

IDBCursor.value/continue steht für zwei API-Elemente: die schreibgeschützte Eigenschaft IDBCursorWithValue.value und die geerbte Methode IDBCursor.continue(). Liefert eine Anfrage mit openCursor() einen Cursor, enthält cursor.value den gespeicherten Wert des aktuellen Datensatzes. Änderungen an Feldern des gelesenen Objekts werden nicht gespeichert. Nutze dafür etwa cursor.update() in einer readwrite-Transaktion. Ein Cursor aus openKeyCursor() hat continue(), aber keine Eigenschaft value.

cursor.continue() fordert den nächsten passenden Datensatz in Laufrichtung an und gibt undefined zurück. cursor.continue(key) sucht die erste folgende Position mit einem Schlüssel >= key bei next oder nextunique beziehungsweise <= key bei prev oder prevunique. Der Zielschlüssel muss nicht existieren; der ursprüngliche Schlüsselbereich gilt weiterhin. Bei einem Objektspeicher zählt der Primärschlüssel, bei einem Index der Indexschlüssel (cursor.key).

Lies request.result bei jedem success-Ereignis derselben Anfrage. null bedeutet, dass nichts passt oder der Durchlauf beendet ist. Lies den Wert und rufe continue() höchstens einmal auf, bevor die Verarbeitung an eine spätere Aufgabe wie einen Timer-Callback übergeht. Ein ungültiger oder in Laufrichtung nicht strikt weiter liegender Schlüssel führt zu DataError. Ein weiterer Aufruf vor dem nächsten Ergebnis, eine fehlende aktuelle Position oder eine gelöschte Quelle kann InvalidStateError verursachen. Bei einer inaktiven Transaktion tritt TransactionInactiveError auf.

IndexedDB ist eine Web-API und kein Teil von ECMAScript 2024. Die Verfügbarkeit hängt von Laufzeitumgebung und Kontext ab. Für den Datenzugriff gilt die Same-Origin-Policy.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IndexedDB cursor example</title>
</head>
<body>
<script>
(() => {
  const name = `cktis-cursor-${crypto.randomUUID()}`;
  const open = indexedDB.open(name, 1);

  open.onupgradeneeded = () => {
    const store = open.result.createObjectStore('items');
    store.add({ name: 'Ada' }, 1);
    store.add({ name: 'Bo' }, 2);
    store.add({ name: 'Lin' }, 4);
  };
  open.onerror = () => console.error(open.error);

  open.onsuccess = () => {
    const db = open.result;
    const tx = db.transaction('items', 'readonly');
    const request = tx.objectStore('items').openCursor();

    const cleanup = () => {
      db.close();
      const deletion = indexedDB.deleteDatabase(name);
      deletion.onerror = () => console.error(deletion.error);
    };
    tx.oncomplete = cleanup;
    tx.onabort = () => {
      console.error(tx.error);
      cleanup();
    };

    request.onsuccess = () => {
      const cursor = request.result;
      if (cursor === null) {
        console.log('Done');
        return;
      }
      console.log(`${cursor.key}: ${cursor.value.name}`);
      if (cursor.key === 1) {
        cursor.continue(3);
      } else {
        cursor.continue();
      }
    };
  };
})();
</script>
</body>
</html>

Ergebnis

1: Ada
4: Lin
Done

Öffne dieses HTML-Dokument über HTTPS als eigenständige Seite in einem Browser-Tab, in dem IndexedDB und `crypto.randomUUID()` verfügbar sind. Die Ausgabe erscheint in der Entwicklerkonsole. Das Beispiel legt eine eigene Testdatenbank an und fordert am Ende ihre Löschung an. `continue(3)` überspringt Schlüssel `2` und landet bei `4`, weil `3` fehlt. Das nächste `continue()` führt zum Ergebnis `null`, worauf der Handler `Done` ausgibt.

Zugehörige Lektionen

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

Quellen