Storage.setItem()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
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
Specification |
---|
HTML Standard # dom-storage-setitem-dev |
Compatibilité des navigateurs
BCD tables only load in the browser