Cet article nécessite une relecture technique. Voici comment vous pouvez aider.
Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.
La méthode count()
de l'interface IDBObjectStore
fait une requête
au magasin d'objet relié
. La requête compte le nombre d'enregistrements dans ce magasin d'objet ou sur l'intervalle de clé
passé en paramètre.
Syntaxe
var request = ObjectStore.count(intervalCleOptionel);
Paramètre
- intervalCleOptionel Facultatif
- L'
intervalle de clé
sur lequel on veut compter. On peut passer une clé seule qui sera alors considéré comme uneintervalle seule
. Par défaut on compte l'ensemble des enregistrements du magasin d'objet.
Renvoie
Exceptions
InvalidStateError
- Cette
exception
est levé si le magasin d'objet a été supprimé. TransactionInactiveError
- Cette
exception
est levé si latransaction
de l'accès
au magasin d’objet est inactive. DataError
- Cette
exception
est levé si l'intervalle de clé
spécifié est invalide.
Exemple
Dans ce morceau de code, on fait une transaction
, ouvre un accès
au magasin d'objet 'fThing'
et compte avec la méthode count()
le nombre d'enregistrements emmagasinés . On affiche le résultat sur la console en cas de succès
.
// ouverture d'une transaction var transaction = db.transaction(['fThings'], 'readonly'); // Accède au magasin d'objet fThings var objectStore = transaction.objectStore('fThings'); // requête de comptage var countRequest = objectStore.count(); //gestionnaire d'événement du succés de la requête de comtage countRequest.onsuccess = function() { // on affiche le résultat sur la console console.log(countRequest.result); }
Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).
Spécification
Spécification | Statut | Commentaire |
---|---|---|
Indexed Database API La définition de 'count()' dans cette spécification. |
Recommendation |
Compatibilité avec les navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Support basique | 23webkit 24 |
10 moz 16.0 (16.0) |
10, en partie | 15 | 7.1 |
Disponible dans workers | (Oui) | 37.0 (37.0) | ? | (Oui) | ? |
Fonctionnalité | Android | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support basique | 4.4 | 22.0 (22.0) | 1.0.1 | 10 | 22 | 8 |
Disponible dans in workers | (Oui) | 37.0 (37.0) | (Oui) | ? | (Oui) | ? |