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 Juli 2015.
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
count()
count(query)
Parameter
queryOptional-
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:
InvalidStateErrorDOMException-
Wird ausgelöst, wenn dieses
IDBObjectStoregelöscht wurde. TransactionInactiveErrorDOMException-
Wird ausgelöst, wenn die Transaktion dieses
IDBObjectStoreinaktiv ist. DataErrorDOMException-
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.
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
Loading…
Siehe auch
- Verwendung von IndexedDB
- Starten von Transaktionen:
IDBDatabase - Verwendung von Transaktionen:
IDBTransaction - Festlegen eines Schlüsselbereichs:
IDBKeyRange - Abrufen und Ändern Ihrer Daten:
IDBObjectStore - Verwendung von Cursoren:
IDBCursor - Referenzbeispiel: To-do Notifications (Beispiel live ansehen).