CKTIS / JavaScript
IndexedDB: branje in premikanje kazalca z `value` in `continue()`
Preberi vrednost trenutnega zapisa prek kazalca IndexedDB in zahtevaj naslednji zapis ali preskoči na položaj, določen s ključem.
Različica: 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čuje dva člana API-ja: lastnost IDBCursorWithValue.value, ki je namenjena samo branju, in podedovano metodo IDBCursor.continue(). Ko zahteva openCursor() vrne kazalec kot rezultat, cursor.value vsebuje shranjeno vrednost trenutnega zapisa. Spreminjanje polj prebranega objekta sprememb ne shrani. Za zapis uporabi na primer cursor.update() v transakciji readwrite. Kazalec iz openKeyCursor() ima continue(), nima pa lastnosti value.
cursor.continue() zahteva naslednji ustrezni zapis v smeri kazalca in vrne undefined. cursor.continue(key) poišče prvi naslednji položaj s ključem >= key pri next ali nextunique oziroma <= key pri prev ali prevunique. Ciljni ključ ni nujno prisoten in prvotni obseg še vedno velja. V shrambi objektov se primerja primarni ključ, v indeksu pa indeksni ključ (cursor.key).
Preberi request.result ob vsakem dogodku success iste zahteve. Vrednost null pomeni, da ni ujemanj ali da je prehod končan. Preberi vrednost in pokliči continue() največ enkrat, preden nadzor prepustiš poznejšemu opravilu, na primer povratnemu klicu časovnika. Neveljaven ključ ali ključ, ki ni strogo naprej v izbrani smeri, povzroči DataError. Ponovni klic pred naslednjim rezultatom, manjkajoči trenutni položaj ali izbrisani vir lahko povzroči InvalidStateError. Nedejavna transakcija povzroči TransactionInactiveError.
IndexedDB je spletni API in ni del ECMAScripta 2024. Razpoložljivost je odvisna od izvajalnega okolja in konteksta. Za dostop do podatkov velja pravilnik istega izvora.
Primeri
<!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
Odpri ta dokument HTML prek HTTPS kot vrhnjo stran v brskalniku, v katerem sta na voljo IndexedDB in `crypto.randomUUID()`. Izpis si oglej v konzoli za razvijalce. Primer ustvari ločeno preizkusno bazo in na koncu zahteva njen izbris. `continue(3)` preskoči ključ `2` in pride do `4`, ker ključa `3` ni. Naslednji `continue()` da rezultat `null`, zato obravnavalnik izpiše `Done`.
Povezane lekcije
- JavaScript · Lekcija 21 · Srednja · Različica: 3
Viri
- 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