From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/storage/setitem/index.html | 139 ++++++++++++++++++++++++++++ 1 file changed, 139 insertions(+) create mode 100644 files/fr/web/api/storage/setitem/index.html (limited to 'files/fr/web/api/storage/setitem/index.html') diff --git a/files/fr/web/api/storage/setitem/index.html b/files/fr/web/api/storage/setitem/index.html new file mode 100644 index 0000000000..d36e170886 --- /dev/null +++ b/files/fr/web/api/storage/setitem/index.html @@ -0,0 +1,139 @@ +--- +title: Storage.setItem() +slug: Web/API/Storage/setItem +tags: + - API + - Méthode + - Stockage + - Stockage Web +translation_of: Web/API/Storage/setItem +--- +

{{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à.

+ +

Syntaxe

+ +
storage.setItem(nomClé, valeurClé);
+ +

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.
+
+ +

Retourne

+ +

Aucune valeur de retour.

+ +

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().

+ +

Exemple

+ +

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

+ +
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é

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
localStorage4{{CompatVersionUnknown}}3.5810.504
sessionStorage5{{CompatUnknown}}2810.504
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidEdgeFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Support basique2.1{{CompatVersionUnknown}}{{ CompatUnknown }}811iOS 3.2
+
+ +

Tous les navigateurs ont des niveaux de capacité de stockage variables, que ce soit pour localStorage ou sessionStorage. Pour un test de l'ensemble des capacités des différents navigateurs voir ici.

+ +
+

Note : Depuis iOS 5.1, Safari Mobile stocke les données liées à localStorage dans un fichier de cache qui est sujet à un nettoyage occasionnel par ordre du système d'exploitation, surtout lorsqu'il reste peu de place.

+
+ +

À voir également

+ +

Utilisation de l'API de stockage web

-- cgit v1.2.3-54-g00ecf