Tutorial de JavaScript

localStorage: guardar datos en el navegador

Al recargar una página, todo lo que tu programa tenía en variables se pierde. localStorage guarda textos en el navegador de la persona para recuperarlos después: su nombre, sus preferencias o su carrito. Aquí verás setItem, getItem y cómo guardar listas con JSON.

localStorage: la memoria del navegador

Las variables de tu programa se borran cada vez que se recarga o se cierra la página. Para que un dato sobreviva, el navegador tiene localStorage: un pequeño cajón donde cada página guarda textos con un nombre (una clave).

localStorage.setItem(clave, valor) guarda; localStorage.getItem(clave) lee. Si esa clave nunca se guardó, getItem devuelve null (nada), y así sabes que es la primera visita.

Lo guardado se queda en ESE navegador y en esa computadora: no viaja a otro equipo ni es secreto. Úsalo para preferencias y datos sencillos, nunca para contraseñas. En el simulador también se conserva entre ejecuciones, como al recargar una página real.

Cómo se escribe

localStorage.setItem("color", "verde") const color = localStorage.getItem("color") localStorage.removeItem("color")

setItem(clave, valor)
guarda el valor (siempre como texto) con ese nombre
getItem(clave)
lee lo guardado; si no existe, da null
removeItem(clave)
borra esa clave
"color"
la clave: el nombre con el que lo guardas y lo buscas (las mayúsculas cuentan)

Ejemplo resuelto

script.js

// La persona eligió el color verde
localStorage.setItem("color", "verde")

// Más tarde (o al volver a abrir la app) se lee
const color = localStorage.getItem("color")
console.log(`Color guardado: ${color}`)

// Una clave que nunca se guardó da null
console.log(localStorage.getItem("fuente"))

Consola

Color guardado: verde

null

App de notas: guarda el color que eligió la persona y lo vuelve a leer.

  • Lee al abrir la página y guarda cuando la persona hace algo (un clic, escribir). Si solo guardas y nunca lees, no se nota nada.
  • La clave debe escribirse IGUAL al guardar y al leer: "nombre" y "Nombre" son dos claves distintas.
  • Para probar como alguien que llega por primera vez, borra lo guardado con localStorage.removeItem("nombre") (y quítalo después).
  • localStorage guarda solo textos: un número vuelve como "5". En el siguiente ejercicio verás cómo guardar listas.

Preguntas frecuentes

¿Cuánto dura lo que guardo?

Hasta que la persona borre los datos del navegador. No caduca solo.

¿Por qué mi lista se guarda como texto raro?

localStorage solo guarda texto. Usa JSON.stringify al guardar y JSON.parse al leer.

¿Puedo guardar contraseñas?

No. Cualquiera con acceso al navegador puede verlo: úsalo para preferencias y datos no sensibles.