El método setItem()
de la interfaz Storage
, cuando reciba una clave y un valor, añadirá estos al almacén, o actualizará el valor si la clave ya existe.
Sintaxis
storage.setItem(keyName, keyValue);
Parámetros
- keyName
- Un
DOMString
conteniendo la clave que se quiere crear/actualizar. - keyValue
- Un
DOMString
conteniendo el valor que se le quiere dar a la clave que se está creando/actualizando.
Devuelve
No devuelve valor.
Excepciones
setItem()
puede lanzar una excepción si el almacén esta lleno. Particularmente, en Safari Mobile (desde iOS 5) siempre lo hará cuando el usuario ingresa en modo privado (Safari determina una cuota de 0 bytes en modo privado, al contrario de otros navegadores, que permiten almacenamiento en modo privado, usando contenedores de información separados).
Por lo tanto, los desarrolladores deben asegurarse de capturar siempre las posibles excepciones de setItem()
.
Ejemplo
La siguiente función crea tres ítems dentro del almacenamiento local.
function populateStorage() { localStorage.setItem('bgcolor', 'red'); localStorage.setItem('font', 'Helvetica'); localStorage.setItem('image', 'myCat.png'); }
Nota: Para ver un ejemplo real, vea nuestro Web Storage Demo.
Especificaciones
Especificación | Estado | Comentario |
---|---|---|
Web Storage (Second edition) The definition of 'setItem()' in that specification. |
Recommendation |
Compatibilidad en navegadores
Funcionalidad | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
localStorage | 4 | 3.5 | 8 | 10.50 | 4 |
sessionStorage | 5 | 2 | 8 | 10.50 | 4 |
Funcionalidad | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Soporte básico | 2.1 | ? | 8 | 11 | iOS 3.2 |
Todos los navegadores tienen niveles de capacidad variados para localStorage y sessionStorage. Aquí hay un análisis detallado de todas las capacidades de almacenamiento para varios navegadores.
Nota: desde iOS 5.1, Safari Mobile almacena los datos de localStorage en la carpeta de caché, que está sujeta a limpieza ocasional a petición del sistema operativo, típicamente cuando el espacio es reducido.