IDBObjectStore: count() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die count()-Methode der IDBObjectStore-Schnittstelle gibt ein IDBRequest-Objekt zurück, und in einem separaten Thread die Gesamtzahl der Datensätze, die mit dem angegebenen Schlüssel oder IDBKeyRange übereinstimmen. Wenn keine Argumente angegeben werden, wird die Gesamtzahl der Datensätze im Speicher zurückgegeben.

Syntax

js
count()
count(query)

Parameter

query Optional

Ein Schlüssel oder ein IDBKeyRange-Objekt, das einen Bereich von Datensätzen festlegt, die Sie zählen möchten.

Rückgabewert

Ein IDBRequest-Objekt, auf dem nachfolgende Ereignisse im Zusammenhang mit dieser Operation ausgelöst werden.

Wenn die Operation erfolgreich ist, ist der Wert der result-Eigenschaft des Antrags die Anzahl der Datensätze, die mit der angegebenen Abfrage übereinstimmen.

Ausnahmen

Diese Methode kann eine DOMException der folgenden Typen auslösen:

InvalidStateError DOMException

Wird ausgelöst, wenn dieses IDBObjectStore gelöscht wurde.

TransactionInactiveError DOMException

Wird ausgelöst, wenn die Transaktion dieses IDBObjectStore inaktiv ist.

DataError DOMException

Wird ausgelöst, wenn der angegebene Schlüssel oder Schlüsselbereich ungültig ist.

Beispiele

In diesem einfachen Fragment erstellen wir eine Transaktion, rufen einen Objektspeicher ab und zählen dann die Anzahl der Datensätze im Speicher mit count() — wenn der Erfolgshandler ausgelöst wird, protokollieren wir den Zählwert (eine ganze Zahl) in der Konsole.

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

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

Spezifikationen

Specification
Indexed Database API 3.0
# ref-for-dom-idbobjectstore-count①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch