IDBIndex: метод count()

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

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

Ключ или диапазон ключей, определяющий запись для подсчёта.

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

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

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

TransactionInactiveError DOMException

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

DataError DOMException

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

InvalidStateError DOMException

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

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

Затем используется myIndex.count(), чтобы подсчитать количество записей в индексе, и результат этого запроса регистрируется в консоли, когда возвращается обратный вызов успешного выполнения.

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

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

  const myIndex = objectStore.index("lName");
  const countRequest = myIndex.count();
  countRequest.onsuccess = () => {
    console.log(countRequest.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
• Пример справки: Уведомления о задачах (смотреть пример онлайн).