CKTIS / JavaScript
IDBCursor — door IndexedDB-records itereren
IDBCursor leest IndexedDB-records achtereenvolgens in sleutelvolgorde. Een cursor met waarde stelt cursor.value beschikbaar, terwijl cursor.continue() asynchroon doorgaat naar het volgende record.
Versie: 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 staat voor een positie tijdens het doorlopen van een IndexedDB-object store of index. openCursor() retourneert een IDBRequest, geen cursor. Lees request.result in onsuccess; als er geen cursor is, eindigt de iteratie. De standaardrichting next betekent oplopende sleutelvolgorde, niet invoegvolgorde.
De naam IDBCursor.value is een beschrijvende verkorting: de eigenschap value wordt eigenlijk gedefinieerd door IDBCursorWithValue, dat overerft van IDBCursor. openCursor() stelt deze cursor beschikbaar; openKeyCursor() stelt value niet beschikbaar. Een object dat door cursor.value wordt geretourneerd aanpassen, slaat de wijzigingen niet op; gebruik update() in een readwrite-transactie om ze op te slaan.
IDBCursor.continue, aangeroepen als cursor.continue(), plant de volgende stap en retourneert undefined, geen Promise. Het resultaat komt binnen via een volgende success-gebeurtenis op hetzelfde verzoek. Roep de methode één keer per stap aan binnen een actieve transactie: nogmaals aanroepen voordat het resultaat er is veroorzaakt InvalidStateError; bij een inactieve transactie treedt TransactionInactiveError op. Wacht tussen stappen niet op niet-gerelateerde asynchrone bewerkingen.
Dit is een Web-API en geen onderdeel van ECMAScript; de aanwezigheid van Node 24 bewijst geen ondersteuning. De beschreven bewerkingen zijn vastgelegd in Indexed Database API 2.0 en 3.0. Controleer de ondersteuning en beschikbaarheid van opslag in de doelbrowser.
Voorbeelden
<!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>Resultaat
1: Alpha 2: Beta
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.