IDBKeyRange

Интерфейс IDBKeyRange API IndexedDB представляет собой непрерывный интервал над некоторым типом данных, используемым для ключей. Записи могут быть извлечены из объектов IDBObjectStore и IDBIndex с использованием ключей или диапазона ключей. Вы можете ограничить диапазон с помощью нижней и верхней границ. Например, вы можете перебрать все значения ключа в диапазоне значений A–Z.

Диапазон ключей может представлять собой одно значение или диапазон с верхними и нижними границами или конечными точками. Если диапазон ключей имеет как верхнюю, так и нижнюю границы, то он является *ограниченным*; если у него нет границ, то он является *неограниченным*. Ограниченный диапазон ключей может быть открытым (конечные точки исключены) или закрытым (конечные точки включены). Для получения всех ключей в определенном диапазоне можно использовать следующие конструкции кода:

Ключ находится в диапазоне ключей, если выполняются следующие условия:

• Нижнее значение диапазона ключей — одно из следующих:

  • undefined
  • Меньше значения ключа
  • Равно значению ключа, если lowerOpen является false.

• Верхнее значение диапазона ключей — одно из следующих:

  • undefined
  • Больше значения ключа
  • Равно значению ключа, если upperOpen является false.

IDBKeyRange.lower Только для чтения

Нижняя граница диапазона ключей.

IDBKeyRange.upper Только для чтения

Верхняя граница диапазона ключей.

IDBKeyRange.lowerOpen Только для чтения

Возвращает false, если значение нижней границы включено в диапазон ключей.

IDBKeyRange.upperOpen Только для чтения

Возвращает false, если значение верхней границы включено в диапазон ключей.

IDBKeyRange.bound()

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

IDBKeyRange.only()

Создает новый диапазон ключей, содержащий одно значение.

IDBKeyRange.lowerBound()

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

IDBKeyRange.upperBound()

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

IDBKeyRange.includes()

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

Следующий пример демонстрирует, как использовать диапазон ключей. Здесь мы объявляем keyRangeValue как диапазон между значениями "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
• Получение и внесение изменений в данные: IDBObjectStore
• Использование курсоров: IDBCursor
• Пример ссылки: Уведомления о задачах (Просмотреть пример в браузере).