CKTIS / JavaScript
IDBCursor — recorrer registros de IndexedDB
IDBCursor lee los registros de IndexedDB de forma secuencial según el orden de las claves. Un cursor con valor expone cursor.value, mientras que cursor.continue() avanza de forma asíncrona al siguiente registro.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
const request = store.openCursor();
request.onsuccess = () => {
const cursor = request.result;
if (!cursor) return;
const value = cursor.value;
cursor.continue();
};IDBCursor representa una posición al recorrer un almacén de objetos o un índice de IndexedDB. openCursor() devuelve un IDBRequest, no un cursor. Lee request.result en onsuccess; si no hay cursor, la iteración termina. La dirección predeterminada, next, significa orden ascendente de claves, no orden de inserción.
El nombre IDBCursor.value es una abreviatura descriptiva: la propiedad value la define realmente IDBCursorWithValue, que hereda de IDBCursor. openCursor() expone ese cursor; openKeyCursor() no expone value. Modificar un objeto devuelto por cursor.value no guarda los cambios; para guardarlos, usa update() en una transacción readwrite.
IDBCursor.continue, invocado como cursor.continue(), programa el siguiente paso y devuelve undefined, no una Promise. El resultado llega en otro evento success de la misma solicitud. Llámalo una vez por paso dentro de una transacción activa: volver a llamarlo antes de obtener el resultado provoca InvalidStateError, mientras que una transacción inactiva provoca TransactionInactiveError. No esperes a que terminen operaciones asíncronas no relacionadas entre pasos.
Esta es una API Web, no parte de ECMAScript; disponer de Node 24 no demuestra que sea compatible. Las operaciones descritas están especificadas en Indexed Database API 2.0 y 3.0. Comprueba la compatibilidad y la disponibilidad del almacenamiento en el navegador de destino.
Ejemplos
<!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>Resultado
1: Alpha 2: Beta
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.