Spec-Zone.ru › Web APIs

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

Базовая Широкодоступная

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

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

Примечание: Эта функция доступна в Web Workers.

Статический метод only() интерфейса IDBKeyRange создаёт новый диапазон ключей, содержащий единственное значение.

Синтаксис

IDBKeyRange.only(value)

Параметры

value

Значение для нового диапазона ключей.

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

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

Исключения

DataError DOMException

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

Примеры

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

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

function displayData() {
  const keyRangeValue = IDBKeyRange.only("A");

  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-only①

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
only_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/only_static

Spec-Zone.ru

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