Window.localStorage

La propiedad de sólo lectura localStorage te permite acceder al objeto local Storage; los datos persisten almacenados entre de las diferentes sesiones de navegación. 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 finaliza la sesion de navegación - lo cual ocurre cuando se cierra la página.

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.

Debe tenerse en cuenta que los datos almacenados tanto en localStorage como en sessionStorage son específicos del protocolo de la página.

Las claves y los valores son siempre cadenas de texto (ten en cuenta que, al igual que con los objetos, las claves de enteros se convertirán automáticamente en cadenas de texto).

Sintaxis

miStorage = window.localStorage;

Valor

Un objeto Storage que se puede utilizar para acceder al espacio de almacenamiento local del origen actual.

Excepciones

SecurityError
La solicitud viola una decisión de política, o el origen no es una tupla válida de protocolo/host/puerto (esto puede suceder si el origen usa el protocolo file: o data:, por ejemplo). Por ejemplo, el usuario puede tener su navegador configurado a fin de denegar el permiso para conservar datos al origen especificado.

Ejemplo

El siguiente código accede al objeto local Storage actual y agrega un ítem al mismo usando Storage.setItem().

localStorage.setItem('miGato', 'Juan');

Nota: Por favor ver el articulo Usando la Web Storage API para un ejemplo completo.

La sintaxis para leer el ítem almacenado en localStorage es la siguiente:

var cat = localStorage.getItem('miGato');

La sintaxis para eliminar el ítem almacenado en localStorage es la siguiente:

localStorage.removeItem('miGato');

La sintaxis para eliminar todos los ítems almacenados en localStorage es la siguiente:

// Elimina todos los elementos
localStorage.clear();

Especificaciones

Especificación  Estado Comentario
Unknown
La definición de 'localStorage' en esta especificación.
Unknown  

Compatibiliad de Navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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.

Ver  también