CKTIS / JavaScript
IndexedDB: четене и преместване на курсор с `value` и `continue()`
Прочети стойността на текущия запис чрез курсор на IndexedDB, след което поискай следващия запис или прескочи до позиция, определена от ключ.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
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 е съкратено означение за два елемента на API: свойството само за четене IDBCursorWithValue.value и наследения метод IDBCursor.continue(). Когато заявка чрез openCursor() върне курсор като резултат, cursor.value дава съхранената стойност на текущия запис. Промяната на полета в прочетения обект не се записва в базата. За запис използвай например cursor.update() в транзакция readwrite. Курсорът от openKeyCursor() има continue(), но няма свойство value.
cursor.continue() заявява следващия подходящ запис по посоката на курсора и връща undefined. cursor.continue(key) търси първата следваща позиция с ключ >= key при next или nextunique, или <= key при prev или prevunique. Целевият ключ не е задължително да съществува, а първоначалният диапазон остава в сила. В хранилище за обекти се сравнява първичният ключ, а в индекс — индексният ключ (cursor.key).
Чети request.result при всяко събитие success на същата заявка. Резултат null означава, че няма съвпадения или че обхождането е приключило. Прочети стойността и извикай continue() най-много веднъж, преди да предадеш управлението на по-късна задача, например функция на таймер. Невалиден ключ или ключ, който не е строго по-напред в избраната посока, предизвиква DataError. Повторно извикване преди следващия резултат, липса на текуща позиция или изтрит източник може да предизвика InvalidStateError. Неактивна транзакция предизвиква TransactionInactiveError.
IndexedDB е уеб API, а не част от ECMAScript 2024. Наличността зависи от средата за изпълнение и контекста. Достъпът до данните следва политиката за един и същ произход.
Примери
<!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>Резултат
1: Ada 4: Lin Done
Отвори този HTML документ през HTTPS като страница от най-горно ниво в браузър, в който са налични IndexedDB и `crypto.randomUUID()`. Виж резултата в конзолата за разработчици. Примерът създава отделна тестова база и накрая заявява изтриването ѝ. `continue(3)` пропуска ключ `2` и стига до `4`, защото ключ `3` липсва. Следващото `continue()` води до резултат `null` и обработчикът извежда `Done`.
Свързани уроци
- JavaScript · Урок 21 · Средно · Версия: 3
Източници
- 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