IDBKeyRange: статический метод bound()

Статический метод bound() интерфейса IDBKeyRange создаёт новый диапазон ключей с указанными верхними и нижними границами. Границы могут быть открытыми (то есть границы не включают конечные значения) или закрытыми (то есть границы включают конечные значения). По умолчанию границы закрыты.

lower

указывает нижнюю границу нового диапазона ключей.

upper

указывает верхнюю границу нового диапазона ключей.

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

указывает, исключает ли нижняя граница конечное значение. По умолчанию — false.

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

указывает, исключает ли верхняя граница конечное значение. По умолчанию — false.

IDBKeyRange: Созданный диапазон ключей.

DataError DOMException

Выбрасывается, когда выполняется одно из следующих условий:

• Параметры lower или upper не содержат допустимого ключа.
• Нижний ключ больше верхнего ключа.
• Нижний и верхний ключи совпадают, и хотя бы одна из границ открыта.

В следующем примере показано, как использовать диапазон ключей bound. Здесь мы объявляем keyRangeValue = IDBKeyRange.bound("A", "F"); — диапазон между значениями "A" и "F". Мы открываем транзакцию (используя IDBTransaction) и объект хранилища, открываем курсор с помощью IDBObjectStore.openCursor, объявляя keyRangeValue в качестве необязательного значения диапазона ключей. Это означает, что курсор будет извлекать только записи с ключами внутри этого диапазона. Этот диапазон включает значения "A" и "F", так как мы не объявляли их как открытые границы. Если бы мы использовали IDBKeyRange.bound("A", "F", true, true);, то диапазон не включал бы "A" и "F", только значения между ними.

function displayData() {
  const keyRangeValue = IDBKeyRange.bound("A", "F");

  const transaction = db.transaction(["fThings"], "readonly");
  const objectStore = transaction.objectStore("fThings");

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

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

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