La propiedad localStorage te permite acceder al objeto local Storage. localStorage es similar a sessionStorage. La única diferencia es que, mientras los datos almacenados en localStorage no tienen fecha de expiración, los datos almacenados en sessionStorage son eliminados cuando el la sesion de navegación finaliza - lo cual ocurre cuando el navegador es cerrado.
Con sessionStorage los datos persisten sólo en la ventana/tab que los creó, mientras que con localStorage los datos persisten entre ventanas/tabs con el mismo origen.
Sintaxis
miStorage = localStorage;
Valor
Un objeto Storage.
Ejemplo
El siguiente codigo accede al objeto local Storage y agrega un item al mismo usando Storage.setItem().
localStorage.setItem('miGato', 'Juan');
Nota: Por favor ver el articulo Usando la Web Storage API para un ejemplo completo.
Especificaciones
| Especificación | Estado | Comentario |
|---|---|---|
| Web Storage (Second edition) The definition of 'localStorage' in that specification. |
Recommendation |
Compatibiliad de 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 variaciones en los niveles de capacidad de almacenamiento tanto para localStorage como para sessionStorage. He aquí un detalle sobre las distintas capacidades en los diferentes navegadores.
Nota: a partir de iOS 5.1, Safari Mobile almacena la data del localStorage en el directorio de cache, lo cual esta sujeto al borrado y perdida ocacional de los datos ante la petición del sistema operativo, tipicamente requerido cuando el dispositivo sufre de falta de espacio de almacenamiento.