diff options
Diffstat (limited to 'files/fr/web/api/idbobjectstore/delete')
| -rw-r--r-- | files/fr/web/api/idbobjectstore/delete/index.md | 133 |
1 files changed, 51 insertions, 82 deletions
diff --git a/files/fr/web/api/idbobjectstore/delete/index.md b/files/fr/web/api/idbobjectstore/delete/index.md index 66ebf75c18..f79aca9cd7 100644 --- a/files/fr/web/api/idbobjectstore/delete/index.md +++ b/files/fr/web/api/idbobjectstore/delete/index.md @@ -8,69 +8,50 @@ tags: - Reference translation_of: Web/API/IDBObjectStore/delete --- -<div>{{APIRef("IndexedDB")}}</div> +{{APIRef("IndexedDB")}} -<p>La méthode <strong><code>delete()</code></strong>, rattachée à l'interface {{domxref("IDBObjectStore")}}, renvoie un objet {{domxref("IDBRequest")}} et, dans un <em>thread</em> séparé, supprime le ou les enregistrements concernés.</p> +La méthode **`delete()`**, rattachée à l'interface {{domxref("IDBObjectStore")}}, renvoie un objet {{domxref("IDBRequest")}} et, dans un _thread_ séparé, supprime le ou les enregistrements concernés. -<p>Cette méthode prend une clé ou un objet {{domxref("IDBKeyRange")}} en argument ce qui permet de supprimer un ou plusieurs enregistrements. Si on souhaite supprimer l'ensemble des enregistrements d'un magasin de données, on utilisera plutôt la méthode {{domxref("IDBObjectStore.clear")}}.</p> +Cette méthode prend une clé ou un objet {{domxref("IDBKeyRange")}} en argument ce qui permet de supprimer un ou plusieurs enregistrements. Si on souhaite supprimer l'ensemble des enregistrements d'un magasin de données, on utilisera plutôt la méthode {{domxref("IDBObjectStore.clear")}}. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var request = objectStore.delete(keyOrKeyRange);</pre> +```js +var request = objectStore.delete(keyOrKeyRange); +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>keyOrKeyRange</code></dt> - <dd>La clé de l'enregistrement qu'on souhaite supprimer ou un objet {{domxref("IDBKeyRange")}} qui indique l'intervalle de clés à supprimer.</dd> -</dl> +- `keyOrKeyRange` + - : La clé de l'enregistrement qu'on souhaite supprimer ou un objet {{domxref("IDBKeyRange")}} qui indique l'intervalle de clés à supprimer. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un objet {{domxref("IDBRequest")}} qui recevra les évènements relatifs à cette opération. <code>request.result</code> vaut {{jsxref("undefined")}}.</p> +Un objet {{domxref("IDBRequest")}} qui recevra les évènements relatifs à cette opération. `request.result` vaut {{jsxref("undefined")}}. -<h3 id="Exceptions">Exceptions</h3> +### Exceptions -<p>Cette méthode peut lever une des exceptions suivantes :</p> +Cette méthode peut lever une des exceptions suivantes : -<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 associée au curseur <code>IDBCursor</code> est inactive.</td> - </tr> - <tr> - <td><code>ReadOnlyError</code></td> - <td>La transaction est uniquement en lecture seule.</td> - </tr> - <tr> - <td><code>InvalidStateError</code></td> - <td>Le curseur créé avec {{domxref("IDBindex.openKeyCursor")}}, est en train d'être parcouru ou a été parcouru après sa fin.</td> - </tr> - <tr> - <td><code>DataError</code></td> - <td>La clé ou l'intervalle de clés n'est pas valide.</td> - </tr> - </tbody> -</table> +| Exception | Description | +| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | +| `TransactionInactiveError` | La transaction associée au curseur `IDBCursor` est inactive. | +| `ReadOnlyError` | La transaction est uniquement en lecture seule. | +| `InvalidStateError` | Le curseur créé avec {{domxref("IDBindex.openKeyCursor")}}, est en train d'être parcouru ou a été parcouru après sa fin. | +| `DataError` | La clé ou l'intervalle de clés n'est pas valide. | -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Dans l'exemple qui suit, on ouvre une transaction en lecture/écriture et on supprime un enregistrement donné grâce à <code>delete()</code>. Pour un exemple complet, voir l'application <a href="https://github.com/mdn/to-do-notifications/">Notifications To-do</a> (<a href="https://mdn.github.io/to-do-notifications/">démonstration</a>).</p> +Dans l'exemple qui suit, on ouvre une transaction en lecture/écriture et on supprime un enregistrement donné grâce à `delete()`. Pour un exemple complet, voir l'application [Notifications To-do](https://github.com/mdn/to-do-notifications/) ([démonstration](https://mdn.github.io/to-do-notifications/)). -<pre class="brush: js">// On ouvre l'accès à la base de données +```js +// On ouvre l'accès à la base de données var DBOpenRequest = window.indexedDB.open("toDoList", 4); DBOpenRequest.onsuccess = function(event) { - note.innerHTML += '<li>Initialisation de la base</li>'; + note.innerHTML += '<li>Initialisation de la base</li>'; // On enregistre le résultat de l'ouverture // dans la variable db. @@ -88,12 +69,12 @@ function deleteData() { // On indique le succès de la transaction transaction.oncomplete = function(event) { - note.innerHTML += '<li>Transaction terminée : modification de la base terminée.</li>'; + note.innerHTML += '<li>Transaction terminée : modification de la base terminée.</li>'; }; transaction.onerror = function(event) { - note.innerHTML += '<li>Transaction interrompue suite à l\'erreur : ' + transaction.error + '</li>'; + note.innerHTML += '<li>Transaction interrompue suite à l\'erreur : ' + transaction.error + '</li>'; }; // On crée un magasin d'objets pour la transaction @@ -104,39 +85,27 @@ function deleteData() { objectStoreRequest.onsuccess = function(event) { // On indique le succès de l'opération - note.innerHTML += '<li>Enregistremnt supprimé.</li>'; + note.innerHTML += '<li>Enregistremnt supprimé.</li>'; }; -};</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('IndexedDB', '#widl-IDBObjectStore-delete-IDBRequest-any-key', 'delete()')}}</td> - <td>{{Spec2('IndexedDB')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.IDBObjectStore.delete")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/API_IndexedDB/Using_IndexedDB">Utiliser IndexedDB</a></li> - <li>Initier une connexion : {{domxref("IDBDatabase")}}</li> - <li>Utiliser les transactions : {{domxref("IDBTransaction")}}</li> - <li>Définir un intervalle de clés : {{domxref("IDBKeyRange")}}</li> - <li>Récupérer et modifier les données : {{domxref("IDBObjectStore")}}</li> - <li>Utiliser les curseurs {{domxref("IDBCursor")}}</li> - <li>L'exemple de référence : <a href="https://github.com/mdn/to-do-notifications/tree/gh-pages">notifications de trucs à faire</a> (<a href="https://mdn.github.io/to-do-notifications/">voir la démonstration</a>)</li> -</ul> +}; +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------ | +| {{SpecName('IndexedDB', '#widl-IDBObjectStore-delete-IDBRequest-any-key', 'delete()')}} | {{Spec2('IndexedDB')}} | | + +## Compatibilité des navigateurs + +{{Compat("api.IDBObjectStore.delete")}} + +## Voir aussi + +- [Utiliser IndexedDB](/fr/docs/Web/API/API_IndexedDB/Using_IndexedDB) +- Initier une connexion : {{domxref("IDBDatabase")}} +- Utiliser les transactions : {{domxref("IDBTransaction")}} +- Définir un intervalle de clés : {{domxref("IDBKeyRange")}} +- Récupérer et modifier les données : {{domxref("IDBObjectStore")}} +- Utiliser les curseurs {{domxref("IDBCursor")}} +- L'exemple de référence : [notifications de trucs à faire](https://github.com/mdn/to-do-notifications/tree/gh-pages) ([voir la démonstration](https://mdn.github.io/to-do-notifications/)) |