English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Manuel de référence JS DOM

Objet Storage JavaScript

setItem()Méthode Storage setItem()

La méthode setItem() de l'objet de stockage définit la valeur de la clé spécifiée dans l'objet de stockage donné, et met à jour la valeur de la clé si elle existe déjà.localStorageObjet ousessionStorrageObjet.

Syntaxe :

localStorage.setItem(key, value)
sessionStorage.setItem(key, value)
;localStorage.setItem('color', 'green');
;localStorage.setItem('image', 'parrot.png');
;localStorage.setItem('url', 'https://fr.oldtoolbag.com');
Testez et voyez‹/›

Compatibilité du navigateur

Les nombres dans le tableau indiquent la première version du navigateur qui prend en charge complètement la méthode setItem() :

Méthode
setItem()43.511.549

Valeur des paramètres

ParamètresDescription
keyContient ce que vous souhaitez créer/Chaîne de caractères du nom de la clé mise à jour
valueContient les éléments à fournir pour créer/Chaîne de caractères de la valeur de la clé mise à jour

Détails techniques

Valeur de retour :Une chaîne de caractères, représentant la valeur insérée
Version DOM :API de stockage réseau

Plus d'exemples

Définir la valeur de l'élément de stockage de session spécifié :

sessionStorage.setItem('time', Date.now());
sessionStorage.setItem('age', 22);
Testez et voyez‹/›

Vous pouvez également utiliser la notation en point pour définir une valeur :

localStorage.color = "green";
localStorage.image = "parrot.png";
localStorage.url = "https://fr.oldtoolbag.com";
Testez et voyez‹/›

Les fonctions suivantes créent trois éléments de données dans le stockage local, puis les utilisent pour définir des styles personnalisés sur la page :

function populateStorage() {
  ;localStorage.setItem('bgcolor', document.getElementById('bgcolor').value);
  ;localStorage.setItem('font', document.getElementById('font').value);
  ;localStorage.setItem('image', document.getElementById('image').value);
}
Testez et voyez‹/›

Références associées

Tutoriel HTML :API de stockage Web

Référence window(Window) :Propriété window.localStorage

Référence window(Window) :Propriété window.sessionStorage

Objet Storage JavaScript