CKTIS / JavaScript
IDBCursor — обхождане на записи в IndexedDB
IDBCursor чете записите в IndexedDB последователно по реда на ключовете. Курсор със стойност предоставя cursor.value, а cursor.continue() асинхронно преминава към следващия запис.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const request = store.openCursor();
request.onsuccess = () => {
const cursor = request.result;
if (!cursor) return;
const value = cursor.value;
cursor.continue();
};IDBCursor представя позиция при обхождане на хранилище за обекти или индекс в IndexedDB. openCursor() връща IDBRequest, а не курсор. Прочетете request.result в onsuccess; ако няма курсор, итерацията приключва. Посоката по подразбиране next означава възходящ ред на ключовете, а не ред на вмъкване.
Името IDBCursor.value е описателно съкращение: свойството value всъщност се дефинира от IDBCursorWithValue, който наследява IDBCursor. openCursor() предоставя този курсор; openKeyCursor() не предоставя value. Промяната на обект, върнат от cursor.value, не записва промените; за да ги запишете, използвайте update() в транзакция readwrite.
IDBCursor.continue, извикан като cursor.continue(), планира следващата стъпка и връща undefined, а не Promise. Резултатът пристига в следващо събитие success за същата заявка. Извиквайте метода веднъж на стъпка в активна транзакция: повторно извикване преди резултата причинява InvalidStateError, а неактивната транзакция причинява TransactionInactiveError. Не изчаквайте несвързани асинхронни операции между стъпките.
Това е Web API, а не част от ECMAScript; наличието на Node 24 не доказва поддръжка. Описаните операции са специфицирани в Indexed Database API 2.0 и 3.0. Проверете поддръжката и наличността на хранилище в целевия браузър.
Примери
<!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>Резултат
1: Alpha 2: Beta
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.