CKTIS / JavaScript
IDBCursor — parcourir les enregistrements IndexedDB
IDBCursor lit les enregistrements IndexedDB successivement, dans l’ordre des clés. Un curseur avec valeur expose cursor.value, tandis que cursor.continue() passe de façon asynchrone à l’enregistrement suivant.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const request = store.openCursor();
request.onsuccess = () => {
const cursor = request.result;
if (!cursor) return;
const value = cursor.value;
cursor.continue();
};IDBCursor représente une position lors du parcours d’un magasin d’objets ou d’un index IndexedDB. openCursor() renvoie un IDBRequest, et non un curseur. Lisez request.result dans onsuccess ; l’absence de curseur met fin à l’itération. Le sens par défaut, next, correspond à l’ordre croissant des clés, et non à l’ordre d’insertion.
Le nom IDBCursor.value est un raccourci descriptif : la propriété value est en réalité définie par IDBCursorWithValue, qui hérite de IDBCursor. openCursor() expose ce curseur ; openKeyCursor() n’expose pas value. Modifier un objet renvoyé par cursor.value n’enregistre pas les changements ; utilisez update() dans une transaction readwrite pour les sauvegarder.
IDBCursor.continue, appelé sous la forme cursor.continue(), planifie l’étape suivante et renvoie undefined, et non une Promise. Le résultat arrive dans un nouvel événement success sur la même requête. Appelez cette méthode une fois par étape dans une transaction active : un nouvel appel avant le résultat provoque InvalidStateError, tandis qu’une transaction inactive provoque TransactionInactiveError. N’attendez pas d’opérations asynchrones sans rapport entre les étapes.
Il s’agit d’une API Web, et non d’une partie d’ECMAScript ; disposer de Node 24 ne prouve pas sa prise en charge. Les opérations décrites sont spécifiées dans Indexed Database API 2.0 et 3.0. Vérifiez la prise en charge et la disponibilité du stockage dans le navigateur cible.
Exemples
<!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>Résultat
1: Alpha 2: Beta
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.