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 (en-US). 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 (en-US) 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
| Specification |
|---|
| HTML Standard # dom-localstorage-dev |
Compatibilidad con navegadores
BCD tables only load in the browser