Storage.setItem()

La méthode setItem() de l'interface 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 DOMString contenant le nom de la clé que l'on souhaite créer/modifier.

valeurClé

C'est une 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');
}

Spécifications

Compatibilité

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

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

À voir également

Utilisation de l'API de stockage web