Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.
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
DOMStringcontenant le nom de la clé que l'on souhaite créer/modifier. - valeurClé
- C'est une
DOMStringcontenant la valeur associéee à 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
Les fonctions suivantes créent 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, regarder notre Web Storage Demo.
Spécifications
| Spécification | Statut | Commentaire |
|---|---|---|
| Web Storage (Second edition) La définition de 'setItem()' dans cette spécification. |
Recommendation |
Compatibilité
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| localStorage | 4 | 3.5 | 8 | 10.50 | 4 |
| sessionStorage | 5 | 2 | 8 | 10.50 | 4 |
| Fonctionnalité | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Support de base | 2.1 | ? | 8 | 11 | iOS 3.2 |
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.
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.