aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/idbobjectstore/getkey
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-10-02 17:20:24 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-10-02 17:30:20 +0200
commit1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch)
tree30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/idbobjectstore/getkey
parentc05efa8d7ae464235cf83d7c0956e42dc6974103 (diff)
downloadtranslated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip
convert content to md
Diffstat (limited to 'files/fr/web/api/idbobjectstore/getkey')
-rw-r--r--files/fr/web/api/idbobjectstore/getkey/index.md122
1 files changed, 45 insertions, 77 deletions
diff --git a/files/fr/web/api/idbobjectstore/getkey/index.md b/files/fr/web/api/idbobjectstore/getkey/index.md
index 84581d2293..a9afc0378f 100644
--- a/files/fr/web/api/idbobjectstore/getkey/index.md
+++ b/files/fr/web/api/idbobjectstore/getkey/index.md
@@ -11,60 +11,42 @@ tags:
- Web API
translation_of: Web/API/IDBObjectStore/getKey
---
-<p>{{APIRef("IndexedDB")}}</p>
+{{APIRef("IndexedDB")}}
-<p>La méthode <strong><code>getKey()</code></strong> de l'interface {{domxref("IDBObjectStore")}} retourne un objet {{domxref("IDBRequest")}}, et, dans un <em>thread</em> séparé, retourne la clé sélectionnée par la requête spécifiée. Cela permet de retrouver un enregistrement spécifique depuis un espace de stockage déterminé.</p>
+La méthode **`getKey()`** de l'interface {{domxref("IDBObjectStore")}} retourne un objet {{domxref("IDBRequest")}}, et, dans un _thread_ séparé, retourne la clé sélectionnée par la requête spécifiée. Cela permet de retrouver un enregistrement spécifique depuis un espace de stockage déterminé.
-<p>Si la clé a bien été retrouvée, alors un clone structuré (une copie conforme) sera créée et servira comme résultat à l'objet de requête.</p>
+Si la clé a bien été retrouvée, alors un clone structuré (une copie conforme) sera créée et servira comme résultat à l'objet de requête.
-<p>{{AvailableInWorkers}}</p>
+{{AvailableInWorkers}}
-<h2 id="Syntax">Syntaxe</h2>
+## Syntaxe
-<pre class="syntaxbox">let <var>request</var> = <var>objectStore</var>.getKey(<var>key</var>);</pre>
+ let request = objectStore.getKey(key);
-<h3 id="Parameters">Paramètres</h3>
+### Paramètres
-<dl>
- <dt><em>key</em></dt>
- <dd>La clé ou l'intervale de clé qui identifie l'enregistrement à retrouver.</dd>
-</dl>
+- _key_
+ - : La clé ou l'intervale de clé qui identifie l'enregistrement à retrouver.
-<h3 id="Return_Value">Valeur de retour</h3>
+### Valeur de retour
-<p>Un objet {{domxref("IDBRequest")}} sur lequel les événements ultérieurs liés à cette opération sont déclenchés.</p>
+Un objet {{domxref("IDBRequest")}} sur lequel les événements ultérieurs liés à cette opération sont déclenchés.
-<h3 id="Exceptions">Exceptions</h3>
+### Exceptions
-<p>Cette méthode peut provoquer une {{domxref("DOMException")}} de l'un des types suivants :</p>
+Cette méthode peut provoquer une {{domxref("DOMException")}} de l'un des types suivants :
-<table class="standard-table">
- <thead>
- <tr>
- <th scope="col">Exception</th>
- <th scope="col">Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>TransactionInactiveError</code></td>
- <td>La transaction de ce {{domxref("IDBObjectStore")}} est inactive.</td>
- </tr>
- <tr>
- <td><code>DataError</code></td>
- <td>La clé ou la plage de clés fournie contient une clé invalide.</td>
- </tr>
- <tr>
- <td><code>InvalidStateError</code></td>
- <td>Le {{domxref("IDBObjectStore")}} a été supprimé ou retiré.</td>
- </tr>
- </tbody>
-</table>
+| Exception | Description |
+| -------------------------- | --------------------------------------------------------------------------- |
+| `TransactionInactiveError` | La transaction de ce {{domxref("IDBObjectStore")}} est inactive. |
+| `DataError` | La clé ou la plage de clés fournie contient une clé invalide. |
+| `InvalidStateError` | Le {{domxref("IDBObjectStore")}} a été supprimé ou retiré. |
-<h2 id="Example">Exemple</h2>
+## Exemple
-<pre class="brush: js">let openRequest = indexedDB.open("telemetry");
-openRequest.onsuccess = (event) =&gt; {
+```js
+let openRequest = indexedDB.open("telemetry");
+openRequest.onsuccess = (event) => {
let db = event.target.result;
let store = db.transaction("netlogs").objectStore("netlogs");
@@ -72,43 +54,29 @@ openRequest.onsuccess = (event) =&gt; {
let yesterday = new Date(today);
yesterday.setDate(today.getDate() - 1);
let request = store.getKey(IDBKeyRange(yesterday, today));
- request.onsuccess = (event) =&gt; {
+ request.onsuccess = (event) => {
let when = event.target.result;
alert("La 1ère activité des dernières 24 heures s'est produite à " + when);
};
-};</pre>
-
-<h2 id="Specifications">Spécifications</h2>
-
-<table class="standard-table">
- <thead>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">Statut</th>
- <th scope="col">Commentaire</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>{{SpecName('IndexedDB 2', '#dom-idbobjectstore-getkey', 'getKey()')}}</td>
- <td>{{Spec2('IndexedDB 2')}}</td>
- <td>Définition initiale.</td>
- </tr>
- </tbody>
-</table>
-
-<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2>
-
-<p>{{Compat("api.IDBObjectStore.getKey")}}</p>
-
-<h2 id="See_also">Voir aussi</h2>
-
-<ul>
- <li><a href="/fr/docs/Web/API/IndexedDB_API/Using_IndexedDB">Utiliser IndexedDB</a></li>
- <li>Transactions de départ : {{domxref("IDBDatabase")}}</li>
- <li>Utilisation des transactions : {{domxref("IDBTransaction")}}</li>
- <li>Réglage d'une fourchette de clés : {{domxref("IDBKeyRange")}}</li>
- <li>Récupération et modification de vos données : {{domxref("IDBObjectStore")}}</li>
- <li>Utilisation des curseurs : {{domxref("IDBCursor")}}</li>
- <li>Exemple de référence : <a href="https://github.com/mdn/to-do-notifications/tree/gh-pages">Notifications des tâches</a> (<a href="https://mdn.github.io/to-do-notifications/">voir l'exemple en direct</a>.)</li>
-</ul>
+};
+```
+
+## Spécifications
+
+| Spécification | Statut | Commentaire |
+| -------------------------------------------------------------------------------------------- | -------------------------------- | -------------------- |
+| {{SpecName('IndexedDB 2', '#dom-idbobjectstore-getkey', 'getKey()')}} | {{Spec2('IndexedDB 2')}} | Définition initiale. |
+
+## Compatibilité des navigateurs
+
+{{Compat("api.IDBObjectStore.getKey")}}
+
+## Voir aussi
+
+- [Utiliser IndexedDB](/fr/docs/Web/API/IndexedDB_API/Using_IndexedDB)
+- Transactions de départ : {{domxref("IDBDatabase")}}
+- Utilisation des transactions : {{domxref("IDBTransaction")}}
+- Réglage d'une fourchette de clés : {{domxref("IDBKeyRange")}}
+- Récupération et modification de vos données : {{domxref("IDBObjectStore")}}
+- Utilisation des curseurs : {{domxref("IDBCursor")}}
+- Exemple de référence : [Notifications des tâches](https://github.com/mdn/to-do-notifications/tree/gh-pages) ([voir l'exemple en direct](https://mdn.github.io/to-do-notifications/).)