Spec-Zone.ru › Web APIs

IDBObjectStore: метод count()

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

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

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

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

Метод count() интерфейса IDBObjectStore возвращает объект IDBRequest, и, в отдельном потоке, возвращает общее количество записей, соответствующих заданному ключу или IDBKeyRange. Если аргументы не указаны, возвращается общее количество записей в хранилище.

Синтаксис

count()
count(query)

Параметры

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

Ключ или объект IDBKeyRange, определяющий диапазон записей, которые нужно посчитать.

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

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

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

Исключения

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

InvalidStateError DOMException

Выбрасывается, если этот IDBObjectStore был удален.

TransactionInactiveError DOMException

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

DataError DOMException

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

Примеры

В этом простом фрагменте мы создаём транзакцию, получаем хранилище объектов, затем считаем количество записей в хранилище, используя count() — когда обработчик успешного завершения выполняется, мы выводим значение подсчёта (целое число) в консоль.

const transaction = db.transaction(["fThings"], "readonly");
const objectStore = transaction.objectStore("fThings");

const countRequest = objectStore.count();
countRequest.onsuccess = () => {
  console.log(countRequest.result);
};

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

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

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

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

Spec-Zone.ru

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