WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

IndexedDB: Datensätze hinzufügen, lesen, löschen und ersetzen

Mit `add()`, `getAll()`, `delete()` und `put()` arbeitest du mit Datensätzen anhand ihres Primärschlüssels. Ein erfolgreicher Request bedeutet noch keinen Commit.

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

Syntax

store.add(value)
store.add(value, key)
store.getAll()
store.getAll(query)
store.getAll(query, count)
store.getAll(options)
store.delete(keyOrRange)
store.put(value)
store.put(value, key)

Die Methoden add(), getAll(), delete() und put() gehören zur IndexedDB-Schnittstelle IDBObjectStore, nicht zu ECMAScript. Den Objektspeicher erhältst du aus einer Transaktion. Für den Datenzugriff gilt die Same-Origin-Policy (Schema, Host und Port); die Unterstützung hängt von der Laufzeitumgebung ab.

add(value) fügt nur ein: Ist der Primärschlüssel schon vorhanden, schlägt der Request mit ConstraintError fehl. put(value) fügt den Wert ein oder ersetzt ihn unter diesem Schlüssel vollständig; Felder werden nicht zusammengeführt. Bei einem internen Schlüssel lässt du das zweite Argument weg: keyPath bezeichnet den Schlüssel im Wert. Bei einem externen Schlüssel übergibst du key als zweites Argument, sofern ihn nicht ein aktivierter Schlüsselgenerator liefern soll. Beide Methoden speichern eine strukturierte Kopie des Werts und liefern bei Erfolg den Schlüssel in request.result. Nicht klonbare Werte wie Funktionen lösen synchron einen DataCloneError aus.

getAll() liefert in request.result ein Array geklonter Werte ohne separat beigefügte Schlüssel; ohne Treffer ist es []. Standardmäßig wird aufsteigend nach Primärschlüssel sortiert, nicht nach Einfügereihenfolge. Mit getAll(query, count) wählst du einen Schlüssel oder einen IDBKeyRange aus und begrenzt die Ergebnisse mit einem positiven count. Mit getAll({ query, count, direction }) kannst du auch die Richtung angeben, etwa "prev" für absteigende Reihenfolge. Prüfe, ob deine Zielbrowser diese Form unterstützen.

delete(keyOrRange) löscht einen Datensatz anhand des Primärschlüssels oder alle Datensätze in einem IDBKeyRange. Bei Erfolg ist das Ergebnis undefined, auch ohne Treffer. Die Methode ist nicht der JavaScript-Operator delete; mit clear() leerst du den Speicher.

Alle vier Methoden geben sofort ein IDBRequest zurück, kein Promise. Zum Lesen genügt readonly; gewöhnliche Schreibvorgänge brauchen readwrite. Stelle Requests, solange die Transaktion aktiv ist, etwa direkt nach dem Erstellen oder in einem Request-Event-Handler, nicht nach dem Warten auf eine Netzwerkantwort. Ein Request-Fehler bricht die Transaktion standardmäßig ab und macht ihre Änderungen rückgängig. success betrifft nur einen Request; complete bestätigt den Commit der Transaktion.

Beispiele

void (async () => {
  const { indexedDB, crypto } = globalThis;
  if (!indexedDB || typeof crypto?.randomUUID !== 'function') {
    throw new Error('Run this example on an HTTPS page in a browser with IndexedDB and crypto.randomUUID() available.');
  }

  const name = `cktis-idb-${crypto.randomUUID()}`;
  const open = indexedDB.open(name, 1);
  open.onupgradeneeded = () => {
    open.result.createObjectStore('tasks', { keyPath: 'id' });
  };
  const db = await new Promise((resolve, reject) => {
    open.onsuccess = () => resolve(open.result);
    open.onerror = () => reject(open.error);
  });

  try {
    const tx = db.transaction('tasks', 'readwrite');
    const store = tx.objectStore('tasks');
    store.add({ id: 2, title: 'Draft', tag: 'temporary' });
    store.add({ id: 1, title: 'Remove me' });
    const before = store.getAll();
    store.put({ id: 2, title: 'Published' });
    store.delete(1);
    const after = store.getAll();

    await new Promise((resolve, reject) => {
      tx.oncomplete = () => resolve();
      tx.onabort = () => reject(tx.error ?? new Error('Transaction aborted'));
    });
    console.log(JSON.stringify(before.result));
    console.log(JSON.stringify(after.result));
  } finally {
    db.close();
    const cleanup = indexedDB.deleteDatabase(name);
    await new Promise((resolve, reject) => {
      cleanup.onsuccess = () => resolve();
      cleanup.onerror = () => reject(cleanup.error);
    });
  }
})().catch((error) => console.error(error));

Ergebnis

[{"id":1,"title":"Remove me"},{"id":2,"title":"Draft","tag":"temporary"}]
[{"id":2,"title":"Published"}]

Führe den Code in der Entwicklerkonsole einer HTTPS-Seite aus, auf der IndexedDB und `crypto.randomUUID()` verfügbar sind und Speicherzugriff erlaubt ist. Nach dem Commit zeigt die erste Zeile beide Datensätze in Schlüsselreihenfolge. Die zweite zeigt, dass `put()` das Feld `tag` nicht übernommen und `delete()` den Datensatz mit Schlüssel `1` gelöscht hat. Der Code schließt die Verbindung und fordert die Löschung der temporären Datenbank an.

Zugehörige Lektionen

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

Quellen