CKTIS / JavaScript
IndexedDB: leggere e spostare un cursore con `value` e `continue()`
Leggi il valore del record corrente di un cursore IndexedDB, poi richiedi il record successivo o raggiungi una posizione in base a una chiave.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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 indica due membri dell’API: la proprietà di sola lettura IDBCursorWithValue.value e il metodo ereditato IDBCursor.continue(). Quando una richiesta openCursor() restituisce un cursore come risultato, cursor.value contiene il valore memorizzato per il record corrente. Modificare i campi dell’oggetto letto non salva le modifiche; per scriverle usa, ad esempio, cursor.update() in una transazione readwrite. Un cursore ottenuto con openKeyCursor() ha continue(), ma non value.
cursor.continue() richiede il prossimo record idoneo nella direzione del cursore e restituisce undefined. cursor.continue(key) cerca la prima posizione successiva con chiave >= key per next o nextunique, oppure <= key per prev o prevunique. La chiave di destinazione non deve necessariamente esistere e l’intervallo iniziale resta valido. Il confronto usa la chiave primaria in un archivio di oggetti e la chiave di indice (cursor.key) in un indice.
Leggi request.result a ogni evento success della stessa richiesta. null indica che non ci sono corrispondenze o che la scansione è terminata. Leggi il valore e chiama continue() al massimo una volta prima di cedere il controllo a un’attività successiva, come la callback di un timer. Una chiave non valida o che non si trova strettamente più avanti nella direzione scelta causa DataError. Una seconda chiamata prima del prossimo risultato, l’assenza di una posizione corrente o l’eliminazione della sorgente può causare InvalidStateError. Una transazione inattiva causa TransactionInactiveError.
IndexedDB è un’API Web e non fa parte di ECMAScript 2024. La disponibilità dipende dall’ambiente di esecuzione e dal contesto; l’accesso ai dati segue la politica della stessa origine.
Esempi
<!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>Risultato
1: Ada 4: Lin Done
Apri questo documento HTML tramite HTTPS come pagina di primo livello in un browser in cui siano disponibili IndexedDB e `crypto.randomUUID()`. Leggi l’output nella console per sviluppatori. L’esempio crea un database di prova separato e ne richiede l’eliminazione alla fine. `continue(3)` salta la chiave `2` e raggiunge `4` perché `3` non esiste. Il `continue()` successivo produce il risultato `null` e il gestore stampa `Done`.
Lezioni correlate
- JavaScript · Lezione 21 · Intermedio · Versione: 3
Fonti
- 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