CKTIS / JavaScript
IndexedDB: čítanie a posun kurzora pomocou `value` a `continue()`
Prečítaj hodnotu aktuálneho záznamu z kurzora IndexedDB a vyžiadaj si ďalší záznam alebo preskoč na pozíciu určenú kľúčom.
Verzia: 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 undefinedIDBCursor.value/continue označuje dva prvky API: vlastnosť IDBCursorWithValue.value iba na čítanie a zdedenú metódu IDBCursor.continue(). Keď požiadavka openCursor() poskytne kurzor, cursor.value obsahuje uloženú hodnotu aktuálneho záznamu. Zmeny polí načítaného objektu sa samy neuložia. Na zápis použi napríklad cursor.update() v transakcii readwrite. Kurzor z openKeyCursor() má continue(), ale nemá vlastnosť value.
cursor.continue() vyžiada ďalší vyhovujúci záznam v smere kurzora a vráti undefined. cursor.continue(key) hľadá prvú nasledujúcu pozíciu s kľúčom >= key pri next alebo nextunique, prípadne <= key pri prev alebo prevunique. Cieľový kľúč nemusí existovať a pôvodný rozsah naďalej platí. V úložisku objektov sa porovnáva primárny kľúč, v indexe kľúč indexu (cursor.key).
Pri každej udalosti success rovnakej požiadavky prečítaj request.result. Hodnota null znamená, že žiadny záznam nevyhovuje alebo že prechod skončil. Prečítaj hodnotu a zavolaj continue() najviac raz pred odovzdaním riadenia neskoršej úlohe, napríklad spätnej funkcii časovača. Neplatný kľúč alebo kľúč, ktorý neleží striktne ďalej vo zvolenom smere, spôsobí DataError. Opakované volanie pred ďalším výsledkom, chýbajúca aktuálna pozícia alebo odstránený zdroj môžu spôsobiť InvalidStateError. Neaktívna transakcia spôsobí TransactionInactiveError.
IndexedDB je webové API, nie súčasť ECMAScriptu 2024. Dostupnosť závisí od behového prostredia a kontextu. Prístup k údajom sa riadi zásadou rovnakého pôvodu.
Prí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ýsledok
1: Ada 4: Lin Done
Otvor tento dokument HTML cez HTTPS ako stránku najvyššej úrovne v prehliadači, kde sú dostupné IndexedDB a `crypto.randomUUID()`. Výstup nájdeš v konzole pre vývojárov. Príklad vytvorí samostatnú testovaciu databázu a na konci požiada o jej odstránenie. `continue(3)` preskočí kľúč `2` a prejde na `4`, pretože kľúč `3` chýba. Ďalšie `continue()` vedie k výsledku `null` a obsluha vypíše `Done`.
Súvisiace lekcie
- JavaScript · Lekcia 21 · Stredne pokročilá · Verzia: 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