IDBCursor

Интерфейс IDBCursor API IndexedDB представляет собой указатель для перебора или итерации по нескольким записям в базе данных.

Указатель имеет источник, указывающий, по какому индексу или объектному хранилищу он выполняется. Он имеет позицию в диапазоне и перемещается в направлении, увеличивающемся или уменьшающемся в порядке ключей записей. Указатель позволяет приложению асинхронно обрабатывать все записи в диапазоне указателя.

Вы можете иметь неограниченное количество указателей одновременно. Вы всегда получаете тот же объект IDBCursor , представляющий данный указатель. Операции выполняются на базовом индексе или объектовом хранилище.

IDBCursor.source Только для чтения

Возвращает IDBObjectStore или IDBIndex, по которому выполняется итерация указателя. Эта функция никогда не возвращает null и не выбрасывает исключение, даже если указатель выполняет итерацию, достигнул конца, или его транзакция неактивна.

IDBCursor.direction Только для чтения

Возвращает направление перебора указателя.

IDBCursor.key Только для чтения

Возвращает ключ записи в позиции указателя. Если указатель находится вне своего диапазона, это значение устанавливается в undefined. Ключ указателя может быть любого типа данных.

IDBCursor.primaryKey Только для чтения

Возвращает текущий эффективный первичный ключ указателя. Если указатель выполняет итерацию или вышел за пределы своего диапазона, это значение устанавливается в undefined. Первичный ключ указателя может быть любого типа данных.

IDBCursor.request Только для чтения

Возвращает IDBRequest, который использовался для получения указателя.

IDBCursor.advance()

Устанавливает количество раз, на которое указатель должен переместиться вперёд.

IDBCursor.continue()

Перемещает указатель к следующей позиции в заданном направлении, к элементу, чей ключ соответствует необязательному параметру key.

IDBCursor.continuePrimaryKey()

Устанавливает указатель на заданный индексный ключ и первичный ключ, указанные в качестве аргументов.

IDBCursor.delete()

Возвращает объект IDBRequest и удаляет запись в позиции указателя в отдельном потоке, не изменяя позицию указателя. Это можно использовать для удаления конкретных записей.

IDBCursor.update()

Возвращает объект IDBRequest и обновляет значение в текущей позиции указателя в объектовом хранилище в отдельном потоке. Это можно использовать для обновления конкретных записей.

• NEXT: "next" : Указатель отображает все записи, включая дубликаты. Он начинается с нижней границы диапазона ключей и перемещается вверх (монотонно увеличиваясь в порядке ключей).
• NEXTUNIQUE : "nextunique" : Указатель отображает все записи, исключая дубликаты. Если несколько записей имеют один и тот же ключ, возвращается только первая итерированная запись. Он начинается с нижней границы диапазона ключей и перемещается вверх.
• PREV: "prev" : Указатель отображает все записи, включая дубликаты. Он начинается с верхней границы диапазона ключей и перемещается вниз (монотонно уменьшаясь в порядке ключей).
• PREVUNIQUE: "prevunique" : Указатель отображает все записи, исключая дубликаты. Если несколько записей имеют один и тот же ключ, возвращается только первая итерированная запись. Он начинается с верхней границы диапазона ключей и перемещается вниз.

В этом простом фрагменте мы создаём транзакцию, получаем объектное хранилище, а затем используем указатель для перебора всех записей в объектовом хранилище. Указателю не нужно выбирать данные на основе ключа; мы можем просто взять их все. Обратите также внимание, что в каждом цикле вы можете получить данные из текущей записи в объекте указателя, используя cursor.value.foo. Для полного рабочего примера см. наш пример IDBCursor (посмотреть пример онлайн.)

function displayData() {
  const transaction = db.transaction(["rushAlbumList"], "readonly");
  const objectStore = transaction.objectStore("rushAlbumList");

  objectStore.openCursor().onsuccess = (event) => {
    const cursor = event.target.result;
    if (cursor) {
      const listItem = document.createElement("li");
      listItem.textContent = `${cursor.value.albumTitle}, ${cursor.value.year}`;
      list.appendChild(listItem);

      cursor.continue();
    } else {
      console.log("Entries all displayed.");
    }
  };
}

• Использование IndexedDB
• Начало транзакций: IDBDatabase
• Использование транзакций: IDBTransaction
• Установка диапазона ключей: IDBKeyRange
• Получение и внесение изменений в данные: IDBObjectStore
• Пример ссылки: Уведомления задач (просмотреть пример онлайн).