CKTIS / JavaScript
IDBCursor — iterare sui record di IndexedDB
IDBCursor legge i record di IndexedDB in sequenza, nell’ordine delle chiavi. Un cursore con valore espone cursor.value, mentre cursor.continue() passa in modo asincrono al record successivo.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const request = store.openCursor();
request.onsuccess = () => {
const cursor = request.result;
if (!cursor) return;
const value = cursor.value;
cursor.continue();
};IDBCursor rappresenta una posizione durante l’attraversamento di un object store o di un indice IndexedDB. openCursor() restituisce un IDBRequest, non un cursore. Leggi request.result in onsuccess; se il cursore manca, l’iterazione termina. La direzione predefinita, next, indica l’ordine crescente delle chiavi, non quello di inserimento.
Il nome IDBCursor.value è una scorciatoia descrittiva: la proprietà value è definita in realtà da IDBCursorWithValue, che eredita da IDBCursor. openCursor() espone questo cursore; openKeyCursor() non espone value. Modificare un oggetto restituito da cursor.value non salva le modifiche; per salvarle, usa update() in una transazione readwrite.
IDBCursor.continue, chiamato come cursor.continue(), pianifica il passaggio successivo e restituisce undefined, non una Promise. Il risultato arriva in un altro evento success della stessa richiesta. Chiama il metodo una volta per passaggio in una transazione attiva: richiamarlo prima del risultato causa InvalidStateError, mentre una transazione inattiva causa TransactionInactiveError. Non aspettare operazioni asincrone non correlate tra un passaggio e l’altro.
Questa è una Web API, non fa parte di ECMAScript; avere Node 24 non dimostra che sia supportata. Le operazioni descritte sono specificate in Indexed Database API 2.0 e 3.0. Verifica il supporto e la disponibilità dello spazio di archiviazione nel browser di destinazione.
Esempi
<!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>Risultato
1: Alpha 2: Beta
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.