IDBИндекс: метод get()

Метод get() интерфейса IDBIndex возвращает объект IDBRequest, и в отдельном потоке находит значение в указанном хранилище объектов, соответствующее заданному ключу, или первое соответствующее значение, если key установлено в IDBKeyRange.

Если значение найдено, то его структурированный клон создаётся и устанавливается в качестве result объекта запроса: это возвращает запись, связанную с ключом.

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

Ключ или IDBKeyRange, который идентифицирует запись, подлежащую извлечению. Если это значение равно null или отсутствует, браузер будет использовать неопределённый диапазон ключей.

Объект IDBRequest, на котором будут срабатывать последующие события, связанные с этой операцией.

Если операция выполнена успешно, значение свойства result запроса — значение первой записи, соответствующей заданному ключу или диапазону ключей.

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

TransactionInactiveError DOMException

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

DataError DOMException

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

InvalidStateError DOMException

Выбрасывается, если IDBIndex был удалён.

В следующем примере мы открываем транзакцию и хранилище объектов, затем получаем индекс lName из простой базы данных контактов. Затем мы открываем базовый курсор на индексе с помощью IDBIndex.openCursor — это работает так же, как открытие курсора непосредственно на ObjectStore с помощью IDBObjectStore.openCursor, за исключением того, что возвращаемые записи сортируются по индексу, а не по первичному ключу.

Затем используется myIndex.get('Bungle') для извлечения записи с lName Bungle, и результат этого запроса регистрируется в консоли, когда возвращается функция обратного вызова успеха.

Наконец, мы проходим по каждой записи и вставляем данные в таблицу HTML. Для получения полных примеров см. нашу демо-репозиторий IndexedDB-examples (посмотреть пример в браузере).

function displayDataByIndex() {
  tableEntry.textContent = "";
  const transaction = db.transaction(["contactsList"], "readonly");
  const objectStore = transaction.objectStore("contactsList");

  const myIndex = objectStore.index("lName");
  const getRequest = myIndex.get("Bungle");
  getRequest.onsuccess = () => {
    console.log(getRequest.result);
  };

  myIndex.openCursor().onsuccess = (event) => {
    const cursor = event.target.result;
    if (cursor) {
      const tableRow = document.createElement("tr");
      for (const cell of [
        cursor.value.id,
        cursor.value.lName,
        cursor.value.fName,
        cursor.value.jTitle,
        cursor.value.company,
        cursor.value.eMail,
        cursor.value.phone,
        cursor.value.age,
      ]) {
        const tableCell = document.createElement("td");
        tableCell.textContent = cell;
        tableRow.appendChild(tableCell);
      }
      tableEntry.appendChild(tableRow);

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

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