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/idbindex/get/index.html | 123 ------------------------------- files/fr/web/api/idbindex/get/index.md | 123 +++++++++++++++++++++++++++++++ 2 files changed, 123 insertions(+), 123 deletions(-) delete mode 100644 files/fr/web/api/idbindex/get/index.html create mode 100644 files/fr/web/api/idbindex/get/index.md (limited to 'files/fr/web/api/idbindex/get') diff --git a/files/fr/web/api/idbindex/get/index.html b/files/fr/web/api/idbindex/get/index.html deleted file mode 100644 index f5cbe56570..0000000000 --- a/files/fr/web/api/idbindex/get/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: IDBIndex.get() -slug: Web/API/IDBIndex/get -translation_of: Web/API/IDBIndex/get ---- -

{{ APIRef("IndexedDB") }}

- -
-

La méthode get() de l'interface {{domxref("IDBIndex")}} fait une requête ({{domxref("IDBRequest")}}) pour renvoyer le premier enregistrement correspondant à la clé ou l'intervalle de clé {{domxref("IDBKeyRange","")}} du magasin d'objet suivant l'index.

-
- -

{{AvailableInWorkers}}

- -

Syntaxe

- -
var request = myIndex.get(key);
- -

Paramètre

- -
-
key
-
la clé ou l'intervalle de clé ({{domxref("IDBKeyRange")}}) de l'enregistrement dont on cherche la valeur.
-
- -

Valeur de retour

- -
-
Une requête ({{domxref("IDBRequest")}})
-
La propriété "result" ({{domxref("IDBRequest.result")}}) de cette requête renvoie en cas de succès le premier enregistrement correspondant à la clé ou à l'intervalle de clé. Le résultat contient l'enregistrement { key: la clé, value: un_clone_structuré_de_la_valeur }.
-
- -

Exceptions

- -
-
TransactionInactiveError
-
Cette exception ( {{domxref("DOMException")}}) est levée si la transaction ({{domxref("IDBTransaction")}}) dont dépend l'accès ({{domxref("IDBObjectStore")}}) au magasin d'objet de cet index est inactive.
-
DataError
-
Cette exception ({{domxref("DOMException")}}) est levée si la clé ou l'intervalle de clé ({{domxref("IDBKeyRange")}}) est invalide.
-
InvalidStateError
-
Cette exception ({{domxref("DOMException")}}) est levée si l'index à été supprimé.
-
- -

Exemple

- -

Dans l'exemple suivant on ouvre une transaction puis un magasin d'objet et enfin l'index lName.

- -

Le code myIndex.get('Bungle') renvoie une requête qui cherche sur l'index un enregistrement dont la clé lName est Bungle. En cas de sucés le résultat de la requête qui contient l'enregistrement est affiché sur la console.

- -

Finalement, on itère sur tous les enregistrements pour en insérer les données dans un tableau HTML. En utilisant la méthode {{domxref("IDBIndex.openCursor")}} qui travaille de la même façon que la méthode {{domxref("IDBObjectStore.openCursor")}} de l'accès ({{domxref("IDBObjectStore")}}) au magasin d'objet sauf que les enregistrements sont renvoyés dans l'ordre de l'index et non celui du magasin d'objet.

- -
function displayDataByIndex() {
-  tableEntry.innerHTML = '';
-
-  //ouvre un transaction
-  var transaction = db.transaction(['contactsList'], 'readonly');
-  //accés au magasin d'objet
-  var objectStore = transaction.objectStore('contactsList');
-
-  //on récupère l'index
-  var myIndex = objectStore.index('lName');
-  //requête de recherche
-  var getRequest = myIndex.get('Bungle');
-  //en cas de succès
-  getRequest.onsuccess = function() {
-    console.log(getRequest.result);
-  }
-
-  //un curseur qui itère sur l'index
-  myIndex.openCursor().onsuccess = function(event) {
-    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>';
-      tableEntry.appendChild(tableRow);
-
-      cursor.continue();
-    } else {
-      console.log('Tous les enregistrements ont été affichés.');
-    }
-  };
-};
- -

Note : Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

- -

Spécification

- - - - - - - - - - - - - - -
SpécificationÈtatCommentaires
{{SpecName('IndexedDB', '#widl-IDBIndex-get-IDBRequest-any-key', 'get()')}}{{Spec2('IndexedDB')}} 
- -

Compatibilité avec les navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/idbindex/get/index.md b/files/fr/web/api/idbindex/get/index.md new file mode 100644 index 0000000000..f5cbe56570 --- /dev/null +++ b/files/fr/web/api/idbindex/get/index.md @@ -0,0 +1,123 @@ +--- +title: IDBIndex.get() +slug: Web/API/IDBIndex/get +translation_of: Web/API/IDBIndex/get +--- +

{{ APIRef("IndexedDB") }}

+ +
+

La méthode get() de l'interface {{domxref("IDBIndex")}} fait une requête ({{domxref("IDBRequest")}}) pour renvoyer le premier enregistrement correspondant à la clé ou l'intervalle de clé {{domxref("IDBKeyRange","")}} du magasin d'objet suivant l'index.

+
+ +

{{AvailableInWorkers}}

+ +

Syntaxe

+ +
var request = myIndex.get(key);
+ +

Paramètre

+ +
+
key
+
la clé ou l'intervalle de clé ({{domxref("IDBKeyRange")}}) de l'enregistrement dont on cherche la valeur.
+
+ +

Valeur de retour

+ +
+
Une requête ({{domxref("IDBRequest")}})
+
La propriété "result" ({{domxref("IDBRequest.result")}}) de cette requête renvoie en cas de succès le premier enregistrement correspondant à la clé ou à l'intervalle de clé. Le résultat contient l'enregistrement { key: la clé, value: un_clone_structuré_de_la_valeur }.
+
+ +

Exceptions

+ +
+
TransactionInactiveError
+
Cette exception ( {{domxref("DOMException")}}) est levée si la transaction ({{domxref("IDBTransaction")}}) dont dépend l'accès ({{domxref("IDBObjectStore")}}) au magasin d'objet de cet index est inactive.
+
DataError
+
Cette exception ({{domxref("DOMException")}}) est levée si la clé ou l'intervalle de clé ({{domxref("IDBKeyRange")}}) est invalide.
+
InvalidStateError
+
Cette exception ({{domxref("DOMException")}}) est levée si l'index à été supprimé.
+
+ +

Exemple

+ +

Dans l'exemple suivant on ouvre une transaction puis un magasin d'objet et enfin l'index lName.

+ +

Le code myIndex.get('Bungle') renvoie une requête qui cherche sur l'index un enregistrement dont la clé lName est Bungle. En cas de sucés le résultat de la requête qui contient l'enregistrement est affiché sur la console.

+ +

Finalement, on itère sur tous les enregistrements pour en insérer les données dans un tableau HTML. En utilisant la méthode {{domxref("IDBIndex.openCursor")}} qui travaille de la même façon que la méthode {{domxref("IDBObjectStore.openCursor")}} de l'accès ({{domxref("IDBObjectStore")}}) au magasin d'objet sauf que les enregistrements sont renvoyés dans l'ordre de l'index et non celui du magasin d'objet.

+ +
function displayDataByIndex() {
+  tableEntry.innerHTML = '';
+
+  //ouvre un transaction
+  var transaction = db.transaction(['contactsList'], 'readonly');
+  //accés au magasin d'objet
+  var objectStore = transaction.objectStore('contactsList');
+
+  //on récupère l'index
+  var myIndex = objectStore.index('lName');
+  //requête de recherche
+  var getRequest = myIndex.get('Bungle');
+  //en cas de succès
+  getRequest.onsuccess = function() {
+    console.log(getRequest.result);
+  }
+
+  //un curseur qui itère sur l'index
+  myIndex.openCursor().onsuccess = function(event) {
+    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>';
+      tableEntry.appendChild(tableRow);
+
+      cursor.continue();
+    } else {
+      console.log('Tous les enregistrements ont été affichés.');
+    }
+  };
+};
+ +

Note : Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

+ +

Spécification

+ + + + + + + + + + + + + + +
SpécificationÈtatCommentaires
{{SpecName('IndexedDB', '#widl-IDBIndex-get-IDBRequest-any-key', 'get()')}}{{Spec2('IndexedDB')}} 
+ +

Compatibilité avec les navigateurs

+ +

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

+ +

Voir aussi

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