Spec-Zone.ru › Web APIs

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

Базовая Широко поддерживается

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2021 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Веб-воркерах.

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

Синтаксис

IDBKeyRange.upperBound(upper)
IDBKeyRange.upperBound(upper, open)

Параметры

upper

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

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

Указывает, исключает ли верхний предел значение конечной точки. По умолчанию — false.

Возвращаемое значение

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

Исключения

DataError DOMException

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

Примеры

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

Если мы использовали бы IDBKeyRange.upperBound("F", true);, то диапазон не включал бы "F" и включал бы только значения, предшествующие ему.

Примечание: Для более полного примера, позволяющего экспериментировать с диапазонами ключей, ознакомьтесь с нашим репозиторием IDBKeyRange-example (посмотреть пример вживую).

function displayData() {
  const keyRangeValue = IDBKeyRange.upperBound("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.");
    }
  };
}

Спецификации

Спецификация
Indexed Database API 3.0
# ref-for-dom-idbkeyrange-upperbound①

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet WebView Android
upperBound_static 23 12 10 15 8 25 22 14 8 1.5 4.4

См. также

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

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IDBKeyRange/upperBound_static

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API