From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/idbcursor/advance/index.html | 114 -------------------------- files/fr/web/api/idbcursor/advance/index.md | 114 ++++++++++++++++++++++++++ 2 files changed, 114 insertions(+), 114 deletions(-) delete mode 100644 files/fr/web/api/idbcursor/advance/index.html create mode 100644 files/fr/web/api/idbcursor/advance/index.md (limited to 'files/fr/web/api/idbcursor/advance') diff --git a/files/fr/web/api/idbcursor/advance/index.html b/files/fr/web/api/idbcursor/advance/index.html deleted file mode 100644 index d7740ad049..0000000000 --- a/files/fr/web/api/idbcursor/advance/index.html +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: IDBCursor.advance() -slug: Web/API/IDBCursor/advance -tags: - - API - - IndexedDB - - Méthode - - Reference -translation_of: Web/API/IDBCursor/advance ---- -
{{APIRef("IndexedDB")}}
- -

La méthode advance() de l'interface {{domxref("IDBCursor")}} définit le nombre d'itérations du curseur avec lequel celui-ci doit se déplacer vers l'avant.

- -

{{AvailableInWorkers}}

- -

Syntaxe

- -
cursor.advance(count);
- -

Paramètres

- -
-
count
-
Le nombre d'itérations du curseur.
-
- -

Valeur de retour

- -

Aucune.

- -

Exceptions

- -

Cette méthode peut déclencher des exceptions  {{domxref("DOMException")}} :

- - - - - - - - - - - - - - - - - - - - - - -
ExceptionDescription
TransactionInactiveErrorCette transaction IDBCursor est inactive.
TypeErrorLa valeur passée au paramètre count vaut zéro ou est négative.
InvalidStateErrorLe curseur est en itération ou a itéré au-delà de la plage.
- -

Exemple

- -

Dans ce petit morceau de code on fait une transaction, récupère un magasin d'objet, puis utilise un curseur pour itérer sur les enregistrements du magasin. Ici, on utilise cursor.advance(2) pour avancer de 2 cases à chaque fois, ce qui signifie que seule la moitié des résultats sera affichée. advance()fonctionne de façon similaire à {{domxref ("IDBCursor.continue")}} mais permet de sauter plusieurs enregistrements à la fois et pas uniquement d'accéder à l'enregistrement suivant.

- -

On notera également que, dans chaque itération de la boucle, on peut  récupérer les données de l'enregistrement en cours grâce à l'objet curseur via curseur.value.foo. Pour un exemple fonctionnel complet, voir notre exemple IDBCursor (l'exemple en live).

- -
function advanceResult() {
-  list.innerHTML = '';
-  var transaction = db.transaction(['granListAlbum'], "readonly");
-  var objectStore = transaction.objectStore('granListAlbum');
-
-  objectStore.openCursor().onsuccess = function(event) {
-    var curseur = event.target.result;
-    if(curseur) {
-      var listItem = document.createElement('li');
-      listItem.innerHTML = '' + curseur.value.titreAlbum + ', ' + curseur.value.annee;
-      list.appendChild(listItem);
-      curseur.advance(2);
-    } else {
-      console.log('moitié des resultats affichée');
-    }
-  };
-};
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('IndexedDB', '#widl-IDBCursor-advance-void-unsigned-long-count', 'advance()')}}{{Spec2('IndexedDB')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("api.IDBCursor.advance")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/idbcursor/advance/index.md b/files/fr/web/api/idbcursor/advance/index.md new file mode 100644 index 0000000000..d7740ad049 --- /dev/null +++ b/files/fr/web/api/idbcursor/advance/index.md @@ -0,0 +1,114 @@ +--- +title: IDBCursor.advance() +slug: Web/API/IDBCursor/advance +tags: + - API + - IndexedDB + - Méthode + - Reference +translation_of: Web/API/IDBCursor/advance +--- +
{{APIRef("IndexedDB")}}
+ +

La méthode advance() de l'interface {{domxref("IDBCursor")}} définit le nombre d'itérations du curseur avec lequel celui-ci doit se déplacer vers l'avant.

+ +

{{AvailableInWorkers}}

+ +

Syntaxe

+ +
cursor.advance(count);
+ +

Paramètres

+ +
+
count
+
Le nombre d'itérations du curseur.
+
+ +

Valeur de retour

+ +

Aucune.

+ +

Exceptions

+ +

Cette méthode peut déclencher des exceptions  {{domxref("DOMException")}} :

+ + + + + + + + + + + + + + + + + + + + + + +
ExceptionDescription
TransactionInactiveErrorCette transaction IDBCursor est inactive.
TypeErrorLa valeur passée au paramètre count vaut zéro ou est négative.
InvalidStateErrorLe curseur est en itération ou a itéré au-delà de la plage.
+ +

Exemple

+ +

Dans ce petit morceau de code on fait une transaction, récupère un magasin d'objet, puis utilise un curseur pour itérer sur les enregistrements du magasin. Ici, on utilise cursor.advance(2) pour avancer de 2 cases à chaque fois, ce qui signifie que seule la moitié des résultats sera affichée. advance()fonctionne de façon similaire à {{domxref ("IDBCursor.continue")}} mais permet de sauter plusieurs enregistrements à la fois et pas uniquement d'accéder à l'enregistrement suivant.

+ +

On notera également que, dans chaque itération de la boucle, on peut  récupérer les données de l'enregistrement en cours grâce à l'objet curseur via curseur.value.foo. Pour un exemple fonctionnel complet, voir notre exemple IDBCursor (l'exemple en live).

+ +
function advanceResult() {
+  list.innerHTML = '';
+  var transaction = db.transaction(['granListAlbum'], "readonly");
+  var objectStore = transaction.objectStore('granListAlbum');
+
+  objectStore.openCursor().onsuccess = function(event) {
+    var curseur = event.target.result;
+    if(curseur) {
+      var listItem = document.createElement('li');
+      listItem.innerHTML = '' + curseur.value.titreAlbum + ', ' + curseur.value.annee;
+      list.appendChild(listItem);
+      curseur.advance(2);
+    } else {
+      console.log('moitié des resultats affichée');
+    }
+  };
+};
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('IndexedDB', '#widl-IDBCursor-advance-void-unsigned-long-count', 'advance()')}}{{Spec2('IndexedDB')}} 
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.IDBCursor.advance")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf