Window.localStorage
Baseline
Ampliamente disponible
Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde julio de 2015.
La propiedad de sólo lectura localStorage te permite acceder al objeto local Storage; los datos persisten almacenados entre 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:odata:, 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 |
|---|
| HTML # dom-localstorage-dev |