Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

IDBObjectStore.count()

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.

Note : Cette fonctionnalité est disponible via les Web Workers.

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 une intervalle seule. Par défaut on compte l'ensemble des enregistrements du magasin d'objet.

Renvoie

Une requête.
Le résultat de la requête en cas de succès est un entier.

Exceptions

InvalidStateError
Cette exception est levé si le magasin d'objet a été supprimé.
TransactionInactiveError
Cette exception est levé si la transaction 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) ?

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : gadgino
 Dernière mise à jour par : gadgino,