From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/idbindex/count/index.md | 152 ++++++++++++++----------------- 1 file changed, 66 insertions(+), 86 deletions(-) (limited to 'files/fr/web/api/idbindex/count') diff --git a/files/fr/web/api/idbindex/count/index.md b/files/fr/web/api/idbindex/count/index.md index 82d71e4b0c..67259dd4f7 100644 --- a/files/fr/web/api/idbindex/count/index.md +++ b/files/fr/web/api/idbindex/count/index.md @@ -9,66 +9,65 @@ tags: - Reference translation_of: Web/API/IDBIndex/count --- -
{{APIRef("IndexedDB")}}
+{{APIRef("IndexedDB")}} -

La méthode count(), rattachée à l'interface {{domxref("IDBIndex")}}, renvoie un objet {{domxref("IDBRequest")}} et, dans un thread séparé, renvoie le nombre d'enregistrements contenu dans un intervalle de clé.

+La méthode **`count()`**, rattachée à l'interface {{domxref("IDBIndex")}}, renvoie un objet {{domxref("IDBRequest")}} et, dans un _thread_ séparé, renvoie le nombre d'enregistrements contenu dans un intervalle de clé. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntaxe

+## Syntaxe -
var request = monIndex.count();
-var request = monIndex.count(cle);
+ var request = monIndex.count(); + var request = monIndex.count(cle); -

Paramètres

+### Paramètres -
-
cle {{optional_inline}}
-
La clé ou l'intervalle de clé qui définit les enregistrements qu'on souhaite compter.
-
+- `cle` {{optional_inline}} + - : La clé ou l'intervalle de clé qui définit les enregistrements qu'on souhaite compter. -

Valeur de retour

+### Valeur de retour -

Un objet {{domxref("IDBRequest")}} sur lequel seront déclenchés les différents évènements relatifs à l'opération.

+Un objet {{domxref("IDBRequest")}} sur lequel seront déclenchés les différents évènements relatifs à l'opération. -

Exceptions

+### Exceptions -

Cette méthode peut déclencher différents types d'exceptions :

+Cette méthode peut déclencher différents types d'exceptions : - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
ExceptionDescription
TransactionInactiveErrorLa transaction associée à cet index est inactive.
DataError -

La clé ou l'intervalle de clé fourni possède une clé invalide.

-
InvalidStateErrorL'index a été supprimé ou retiré.
ExceptionDescription
TransactionInactiveErrorLa transaction associée à cet index est inactive.
DataError +

La clé ou l'intervalle de clé fourni possède une clé invalide.

+
InvalidStateErrorL'index a été supprimé ou retiré.
-

Exemples

+## Exemples -

Dans l'exemple qui suit, on ouvre une transaction et un magasin d'objets puis on récupère l'index lName depuis une base de données de contacts. Ensuite, on ouvre un curseur simple sur cet index grâce à la méthode {{domxref("IDBIndex.openCursor")}} (ce qui fonctionne comme si on ouvrait un curseur sur le magasin d'objets avec {{domxref("IDBObjectStore.openCursor")}} sauf que les enregistrements sont ici triés selon l'index plutôt que selon la clé primaire).

+Dans l'exemple qui suit, on ouvre une transaction et un magasin d'objets puis on récupère l'index `lName` depuis une base de données de contacts. Ensuite, on ouvre un curseur simple sur cet index grâce à la méthode {{domxref("IDBIndex.openCursor")}} (ce qui fonctionne comme si on ouvrait un curseur sur le magasin d'objets avec {{domxref("IDBObjectStore.openCursor")}} sauf que les enregistrements sont ici triés selon l'index plutôt que selon la clé primaire). -

myIndex.count() est alors utilisé afin de compter le nombre d'enregistrements dans l'index et le résultat de la requête est affiché dans la console au travers du gestionnaire d'évènements pour la réussite (onsuccess).

+`myIndex.count()` est alors utilisé afin de compter le nombre d'enregistrements dans l'index et le résultat de la requête est affiché dans la console au travers du gestionnaire d'évènements pour la réussite (`onsuccess`). -

Efin, on parcourt chaque enregistrement pour l'insérer dans un tableau HTML. Pour consulter un exemple fonctionnel complet, vous pouvez vous référer à notre dépôt IDBIndex-example (cf. la démonstration live).

+Efin, on parcourt chaque enregistrement pour l'insérer dans un tableau HTML. Pour consulter un exemple fonctionnel complet, vous pouvez vous référer à notre dépôt [IDBIndex-example](https://github.com/mdn/IDBIndex-example) ([cf. la démonstration _live_](https://mdn.github.io/IDBIndex-example/)). -
function displayDataByIndex() {
+```js
+function displayDataByIndex() {
   tableEntry.innerHTML = '';
   var transaction = db.transaction(['contactsList'], 'readonly');
   var objectStore = transaction.objectStore('contactsList');
@@ -83,14 +82,14 @@ var request = monIndex.count(cle);
var cursor = event.target.result; if(cursor) { var tableRow = document.createElement('tr'); - tableRow.innerHTML = '<td>' + cursor.value.id + '</td>' - + '<td>' + cursor.value.lName + '</td>' - + '<td>' + cursor.value.fName + '</td>' - + '<td>' + cursor.value.jTitle + '</td>' - + '<td>' + cursor.value.company + '</td>' - + '<td>' + cursor.value.eMail + '</td>' - + '<td>' + cursor.value.phone + '</td>' - + '<td>' + cursor.value.age + '</td>'; + tableRow.innerHTML = '' + cursor.value.id + '' + + '' + cursor.value.lName + '' + + '' + cursor.value.fName + '' + + '' + cursor.value.jTitle + '' + + '' + cursor.value.company + '' + + '' + cursor.value.eMail + '' + + '' + cursor.value.phone + '' + + '' + cursor.value.age + ''; tableEntry.appendChild(tableRow); cursor.continue(); @@ -98,45 +97,26 @@ var request = monIndex.count(cle); console.log('Éléments affichés.'); } }; -}; +}; +``` -

Spécifications

+## Spécifications -
-
+| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------ | +| {{SpecName('IndexedDB', '#widl-IDBIndex-count-IDBRequest-any-key', 'count()')}} | {{Spec2('IndexedDB')}} |   | +| {{SpecName("IndexedDB 2", "#dom-idbindex-count", "count()")}} | {{Spec2("IndexedDB 2")}} |   | - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('IndexedDB', '#widl-IDBIndex-count-IDBRequest-any-key', 'count()')}}{{Spec2('IndexedDB')}} 
{{SpecName("IndexedDB 2", "#dom-idbindex-count", "count()")}}{{Spec2("IndexedDB 2")}} 
- -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.IDBIndex.count")}}

+{{Compat("api.IDBIndex.count")}} -

Voir aussi

+## Voir aussi - +- [Manipuler IndexedDB](/fr/docs/Web/API/API_IndexedDB/Using_IndexedDB) +- Démarrer des transactions : {{domxref("IDBDatabase")}} +- Manipuler des transactions : {{domxref("IDBTransaction")}} +- Définir un intervalle de clés : {{domxref("IDBKeyRange")}} +- Récupérer des données et les modifier : {{domxref("IDBObjectStore")}} +- Manipuler des curseurs : {{domxref("IDBCursor")}} +- Exemple de référence pour IndexedDB : [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) -- cgit v1.2.3-54-g00ecf