Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

IDBCursor — prechádzanie záznamov IndexedDB

IDBCursor číta záznamy IndexedDB postupne v poradí kľúčov. Kurzor s hodnotou sprístupňuje cursor.value, zatiaľ čo cursor.continue() asynchrónne prejde na ďalší záznam.

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

Syntax

const request = store.openCursor();
request.onsuccess = () => {
  const cursor = request.result;
  if (!cursor) return;
  const value = cursor.value;
  cursor.continue();
};

IDBCursor predstavuje pozíciu pri prechádzaní úložiska objektov alebo indexu IndexedDB. openCursor() vracia IDBRequest, nie kurzor. Čítajte request.result v onsuccess; ak kurzor chýba, iterácia sa končí. Predvolený smer next znamená vzostupné poradie kľúčov, nie poradie vloženia.

Názov IDBCursor.value je opisná skratka: vlastnosť value v skutočnosti definuje IDBCursorWithValue, ktorý dedí z IDBCursor. openCursor() sprístupňuje tento kurzor; openKeyCursor() vlastnosť value nesprístupňuje. Zmena objektu vráteného z cursor.value zmeny neuloží; na ich uloženie použite update() v transakcii readwrite.

IDBCursor.continue, volané ako cursor.continue(), naplánuje ďalší krok a vracia undefined, nie Promise. Výsledok príde v ďalšej udalosti success tej istej požiadavky. V aktívnej transakcii metódu volajte raz pre každý krok: opätovné zavolanie pred výsledkom spôsobí InvalidStateError, zatiaľ čo neaktívna transakcia spôsobí TransactionInactiveError. Medzi krokmi nečakajte na nesúvisiace asynchrónne operácie.

Ide o Web API, nie súčasť ECMAScriptu; samotná dostupnosť Node 24 nepotvrdzuje podporu. Opísané operácie sú špecifikované v Indexed Database API 2.0 a 3.0. V cieľovom prehliadači overte podporu aj dostupnosť úložiska.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Iterating records with IDBCursor</title>
</head>
<body>
<script>
  (() => {
    // This disposable name does not require a secure-context API.
    const name = `cktis-cursor-${Date.now()}-${Math.random()}`;
    const unavailable = () => console.log('IndexedDB unavailable in this context.');
    let open;
    try {
      open = indexedDB.open(name, 1);
    } catch {
      unavailable();
      return;
    }
    open.onerror = unavailable;
    open.onupgradeneeded = () => {
      const store = open.result.createObjectStore('items');
      store.put('Beta', 2);
      store.put('Alpha', 1);
    };
    open.onsuccess = () => {
      const db = open.result;
      const rows = [];
      const tx = db.transaction('items', 'readonly');
      const request = tx.objectStore('items').openCursor();
      request.onsuccess = () => {
        const cursor = request.result;
        if (cursor === null) return;
        rows.push(`${cursor.key}: ${cursor.value}`);
        cursor.continue();
      };
      function cleanup() {
        db.close();
        indexedDB.deleteDatabase(name);
      }
      tx.oncomplete = () => {
        for (const row of rows) console.log(row);
        cleanup();
      };
      tx.onabort = () => {
        cleanup();
        console.log('Cursor transaction aborted.');
      };
    };
  })();
</script>
</body>
</html>

Výsledok

1: Alpha
2: Beta

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje