IDBCursor: метод continue()

Метод continue() интерфейса IDBCursor перемещает курсор в следующую позицию в его направлении до элемента, ключ которого соответствует необязательному параметру key. Если ключ не указан, курсор перемещается в непосредственную следующую позицию, основываясь на его направлении.

key Необязательно

Ключ, на котором нужно установить курсор.

None (undefined).

Этот метод может вызывать исключение DOMException одного из следующих типов:

TransactionInactiveError DOMException

Выбрасывается, если транзакция данного IDBCursor неактивна.

DataError DOMException

Выбрасывается, если параметр key имеет следующие условия:

• Ключ не является допустимым ключом.
• Ключ меньше или равен позиции этого курсора, а направление курсора — next или nextunique.
• Ключ больше или равен позиции этого курсора, а направление курсора — prev или prevunique.

InvalidStateError DOMException

Выбрасывается, если курсор в данный момент итерируется или прошёл конец итерации.

В этом простом фрагменте мы создаём транзакцию, получаем хранилище объектов, а затем используем курсор для итерирования по всем записям в хранилище объектов. Курсору не нужно выбирать данные на основе ключа; мы можем просто получить все. Также обратите внимание, что на каждой итерации цикла вы можете получить данные из текущей записи в объекте курсора, используя 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
• Использование курсоров: IDBCursor
• Пример ссылки: Уведомления о задачах (Посмотреть пример в действии).