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