CKTIS / JavaScript
IndexedDB: čitanje i pomicanje kursora pomoću `value` i `continue()`
Pročitaj vrijednost trenutačnog zapisa preko kursora IndexedDB-a pa zatraži sljedeći zapis ili prijeđi na položaj određen ključem.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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čava dva člana API-ja: svojstvo IDBCursorWithValue.value samo za čitanje i naslijeđenu metodu IDBCursor.continue(). Kad zahtjev openCursor() vrati kursor kao rezultat, cursor.value daje pohranjenu vrijednost trenutačnog zapisa. Promjene polja dohvaćenog objekta ne spremaju se same. Za zapis upotrijebi, primjerice, cursor.update() u transakciji readwrite. Kursor iz openKeyCursor() ima continue(), ali nema svojstvo value.
cursor.continue() traži sljedeći odgovarajući zapis u smjeru kursora i vraća undefined. cursor.continue(key) traži prvi sljedeći položaj s ključem >= key za next ili nextunique, odnosno <= key za prev ili prevunique. Ciljni ključ ne mora postojati, a početni raspon i dalje vrijedi. U spremištu objekata uspoređuje se primarni ključ, a u indeksu ključ indeksa (cursor.key).
Pročitaj request.result pri svakom događaju success istog zahtjeva. Rezultat null znači da nema podudaranja ili da je obilazak završen. Pročitaj vrijednost i pozovi continue() najviše jednom prije nego što prepustiš kontrolu kasnijem zadatku, primjerice povratnom pozivu vremenskog programatora. Nevaljan ključ ili ključ koji nije strogo dalje u zadanom smjeru uzrokuje DataError. Ponovni poziv prije sljedećeg rezultata, izostanak trenutačnog položaja ili obrisan izvor može uzrokovati InvalidStateError. Neaktivna transakcija uzrokuje TransactionInactiveError.
IndexedDB je web API, a ne dio ECMAScripta 2024. Dostupnost ovisi o izvršnom okruženju i kontekstu. Pristup podacima slijedi pravilo istog izvora.
Primjeri
<!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>Rezultat
1: Ada 4: Lin Done
Otvori ovaj HTML dokument putem HTTPS-a kao stranicu najviše razine u pregledniku u kojem su dostupni IndexedDB i `crypto.randomUUID()`. Izlaz pogledaj u razvojnoj konzoli. Primjer stvara zasebnu testnu bazu i na kraju traži njezino brisanje. `continue(3)` preskače ključ `2` i dolazi do `4` jer ključ `3` ne postoji. Sljedeći `continue()` daje rezultat `null`, pa rukovatelj ispisuje `Done`.
Povezane lekcije
- JavaScript · Lekcija 21 · Srednje · Verzija: 3
Izvori
- 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