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: 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

Specification
HTML Standard
# dom-localstorage-dev

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también