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/storage/setitem/index.md | 91 +++++++++++++------------------ 1 file changed, 38 insertions(+), 53 deletions(-) (limited to 'files/fr/web/api/storage/setitem') diff --git a/files/fr/web/api/storage/setitem/index.md b/files/fr/web/api/storage/setitem/index.md index ce945681ff..da20ec878f 100644 --- a/files/fr/web/api/storage/setitem/index.md +++ b/files/fr/web/api/storage/setitem/index.md @@ -8,71 +8,56 @@ tags: - Stockage Web translation_of: Web/API/Storage/setItem --- -

{{APIRef("Web Storage API")}}

+{{APIRef("Web Storage API")}} -

La méthode setItem() de l'interface {{domxref("Storage")}}, lorsque lui sont passées le duo clé-valeur, les ajoute à l'emplacement de stockage, sinon elle met à jour la valeur si la clé existe déjà.

+La méthode `setItem()` de l'interface {{domxref("Storage")}}, lorsque lui sont passées le duo clé-valeur, les ajoute à l'emplacement de stockage, sinon elle met à jour la valeur si la clé existe déjà. -

Syntaxe

+## Syntaxe -
storage.setItem(nomClé, valeurClé);
+ storage.setItem(nomClé, valeurClé); -

Paramètres

+### Paramètres -
-
nomClé
-
C'est une {{domxref("DOMString")}} contenant le nom de la clé que l'on souhaite créer/modifier.
-
valeurClé
-
C'est une {{domxref("DOMString")}} contenant la valeur associée à son nom de clé que l'on souhaite créer/modifier.
-
+- _nomClé_ + - : C'est une {{domxref("DOMString")}} contenant le nom de la clé que l'on souhaite créer/modifier. +- _valeurClé_ + - : C'est une {{domxref("DOMString")}} contenant la valeur associée à son nom de clé que l'on souhaite créer/modifier. -

Retourne

+### Retourne -

Aucune valeur de retour.

+_Aucune valeur de retour._ -

Exceptions

+### Exceptions -

setItem() peut émettre une exception si l'emplacement de stockage est plein. En particulier pour Safari mobile (depuis iOS 5), elle émettra une exception si l'utilisateur passe en navigation privée (contrairement aux autres navigateur qui autorisent le stockage même en navigation privée en utilisant un conteneur de données séparé, Safari met son quota de stockage à 0 octets).
- Par conséquent les développeurs devraient être sûrs de toujours de systématiquement capturer toute possible exception venant de setItem().

+`setItem()` peut émettre une exception si l'emplacement de stockage est plein. En particulier pour Safari mobile (depuis iOS 5), elle émettra une exception si l'utilisateur passe en navigation privée (contrairement aux autres navigateur qui autorisent le stockage même en navigation privée en utilisant un conteneur de données séparé, Safari met son quota de stockage à 0 octets). +Par conséquent les développeurs devraient être sûrs de toujours de **systématiquement capturer toute possible exception venant de setItem().** -

Exemple

+## Exemple -

La fonction suivante crée trois éléments à l'intérieur du stockage local.

+La fonction suivante crée trois éléments à l'intérieur du stockage local. -
function remplissageStockage() {
+```js
+function remplissageStockage() {
   localStorage.setItem('bgcolor', 'red');
   localStorage.setItem('font', 'Helvetica');
   localStorage.setItem('image', 'myCat.png');
-}
- -
-

Note : Pour voir ceci utilisé dans un exemple concret, regardez notre Web Storage Demo.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-setitem', 'Storage.setItem')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Storage.setItem")}}

- -

Voir aussi

- - +} +``` + +> **Note :** Pour voir ceci utilisé dans un exemple concret, regardez notre [Web Storage Demo](https://mdn.github.io/dom-examples/web-storage/). + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-setitem', 'Storage.setItem')}} | {{Spec2('HTML WHATWG')}} | | + +## Compatibilité des navigateurs + +{{Compat("api.Storage.setItem")}} + +## Voir aussi + +- [Storage.getItem()](/fr/docs/Web/API/Storage/getItem) +- [Storage.removeItem()](/fr/docs/Web/API/Storage/removeItem) +- [Utilisation de l'API Web Storage](/fr/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API) -- cgit v1.2.3-54-g00ecf