CKTIS / JavaScript
IndexedDB: čtení a posun kurzoru pomocí `value` a `continue()`
Přečti hodnotu aktuálního záznamu z kurzoru IndexedDB a vyžádej si další záznam nebo přeskoč na pozici určenou klíčem.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 undefinedIDBCursor.value/continue je zkratka pro dva prvky API: vlastnost IDBCursorWithValue.value pouze pro čtení a zděděnou metodu IDBCursor.continue(). Pokud požadavek openCursor() poskytne kurzor, cursor.value obsahuje uloženou hodnotu aktuálního záznamu. Změny polí načteného objektu se samy neuloží. K zápisu použij například cursor.update() v transakci readwrite. Kurzor z openKeyCursor() má metodu continue(), ale nemá vlastnost value.
cursor.continue() vyžádá další vyhovující záznam ve směru kurzoru a vrátí undefined. cursor.continue(key) hledá první následující pozici s klíčem >= key pro next nebo nextunique, případně <= key pro prev nebo prevunique. Cílový klíč nemusí existovat a původní rozsah dál platí. V objektovém úložišti se porovnává primární klíč, v indexu klíč indexu (cursor.key).
Při každé události success téhož požadavku přečti request.result. Hodnota null znamená, že žádný záznam nevyhovuje nebo že průchod skončil. Přečti hodnotu a zavolej continue() nejvýše jednou před předáním řízení pozdější úloze, například zpětnému volání časovače. Neplatný klíč nebo klíč, který neleží přísně dál ve zvoleném směru, způsobí DataError. Opakované volání před dalším výsledkem, chybějící aktuální pozice nebo odstraněný zdroj mohou způsobit InvalidStateError. Neaktivní transakce způsobí TransactionInactiveError.
IndexedDB je webové API, nikoli součást ECMAScriptu 2024. Dostupnost závisí na běhovém prostředí a kontextu. Přístup k datům se řídí zásadou stejného původu.
Příklady
<!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>Výsledek
1: Ada 4: Lin Done
Otevři tento dokument HTML přes HTTPS jako stránku nejvyšší úrovně v prohlížeči, kde jsou dostupné IndexedDB a `crypto.randomUUID()`. Výstup najdeš ve vývojářské konzoli. Příklad vytvoří samostatnou testovací databázi a po skončení požádá o její smazání. `continue(3)` přeskočí klíč `2` a skončí na `4`, protože klíč `3` chybí. Další `continue()` vede k výsledku `null` a obsluha vypíše `Done`.
Související lekce
- JavaScript · Lekce 21 · Středně pokročilá · Verze: 3
Zdroje
- IDBCursorWithValue: value property
- IDBCursor: continue() method
- IDBObjectStore: openCursor() method
- IDBIndex: openCursor() method
- IDBObjectStore: openKeyCursor() method
- IDBCursor: update() method
- IDBTransaction
- IndexedDB API
- Crypto: randomUUID() method
- IDBFactory: deleteDatabase() method
- ECMAScript 2024 Language Specification: Hosts and Implementations