Las opciones
| Almacén | Dura | Tamaño | API | Para |
|---|---|---|---|---|
localStorage |
Hasta que se borre | Unos 5 MB | Síncrona, solo texto | Preferencias, borradores pequeños |
sessionStorage |
Mientras dure la pestaña | Unos 5 MB | Síncrona, solo texto | Estado de un proceso en curso |
| IndexedDB | Hasta que se borre | Mucho (una parte del disco) | Asíncrona, objetos y archivos | Datos grandes, apps sin conexión |
| Cache API | Hasta que se borre | Mucho | Asíncrona, peticiones y respuestas | Archivos para usar sin conexión |
| Cookies | Hasta su fecha | Unos 4 KB | Texto, viajan al servidor | Sesiones, preferencias que el servidor necesita |
Todos son por origen: una página solo ve lo que guardó su propio dominio.
localStorage y sessionStorage
localStorage.setItem("tema", "oscuro");
console.log(localStorage.getItem("tema")); // "oscuro"
console.log(localStorage.getItem("idioma")); // null: no existe
localStorage.removeItem("tema");
localStorage.clear(); // borra todo lo de este origen
Solo guardan textos. Para objetos y arrays, conviértelos con JSON:
const carrito = [{ id: 7, cantidad: 2 }];
localStorage.setItem("carrito", JSON.stringify(carrito));
const guardado = JSON.parse(localStorage.getItem("carrito") ?? "[]");
Y lee siempre a la defensiva: la clave puede no existir, o el texto puede estar dañado (por una versión anterior de tu código, por ejemplo). Lo vas a resolver en el laboratorio.
Si el usuario tiene la página abierta en dos pestañas, el evento storage avisa a las demás cuando una cambia algo:
window.addEventListener("storage", (e) => {
if (e.key === "tema") aplicarTema(e.newValue);
});
IndexedDB
Una base de datos completa en el navegador: guarda objetos (no solo textos), archivos, millones de registros, con índices para buscar. Es asíncrona, así que no bloquea la página. Su API original, basada en eventos, es incómoda; en la práctica se usa con una librería pequeña como idb:
import { openDB } from "idb";
const db = await openDB("tienda", 1, {
upgrade(db) {
db.createObjectStore("pedidos", { keyPath: "id" });
},
});
await db.put("pedidos", { id: 1, total: 25, fecha: new Date() });
const pedido = await db.get("pedidos", 1);
Cookies
Las cookies se envían al servidor en cada petición, y por eso son el lugar para las sesiones. Las que crea el servidor con el atributo HttpOnly no se pueden leer desde JavaScript, y eso protege la sesión si alguien inyecta un script en la página. Desde JavaScript, la API moderna es cookieStore:
await cookieStore.set({ name: "idioma", value: "es", expires: Date.now() + 30 * 864e5 });
const idioma = await cookieStore.get("idioma");
Resumen
localStorage(permanente) ysessionStorage(por pestaña): síncronos, pequeños y solo de texto. Usa JSON.- Lee a la defensiva:
nullsi no existe, y untry/catchalrededor deJSON.parse. - IndexedDB para datos grandes o estructurados; la Cache API para respuestas y archivos.
- Las cookies viajan al servidor; las
HttpOnlyno las ve JavaScript. - Lo guardado en el navegador lo puede ver y cambiar el usuario.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Recordar entre visitas
Resuelto
Elige una respuesta en cada pregunta.
¿Qué tipo de valor guarda
localStorage?¿Qué diferencia hay entre
localStorageysessionStorage?¿Cuándo conviene IndexedDB en lugar de
localStorage?¿Es seguro guardar un token de sesión en
localStorage?
Ordena la salida: Todo se vuelve texto
Resuelto
Un número, un objeto y una clave que no existe. Ordena lo que aparecería en la consola.
1localStorage.clear();2localStorage.setItem("visitas", 3);3localStorage.setItem("usuario", { nombre: "Ana" });4 5console.log(typeof localStorage.getItem("visitas"));6console.log(localStorage.getItem("usuario"));7console.log(localStorage.getItem("no-existe"));8console.log(localStorage.length);Consola, de arriba abajo
- null
- string
- 2
- [object Object]
El número se guardó como el texto "3", y el objeto, con su conversión por defecto: "[object Object]", que ya no sirve para nada. Leer una clave que no existe da null.
Detective: Un carrito que todavía no existe
Resuelto
La página funciona para quien ya compró, pero falla en la primera visita. Encuentra la línea y elige el arreglo.
Consola
Uncaught TypeError: Cannot read properties of null (reading 'length')
at carrito.js:3:30Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Preferencias que sobreviven
Resuelto
Escribe guardar y leer: cualquier valor con JSON, y un valor por defecto cuando no hay nada o está dañado.
La página index.html
Consola del navegador
Lo que debe cumplir
- La página muestra
Tema oscuro, letra 18(pendiente) - Guarda y recupera arrays, números y booleanos (pendiente)
- Devuelve el valor por defecto si no existe o está dañado (pendiente)
Una solución
1function guardar(clave, valor) {2 localStorage.setItem(clave, JSON.stringify(valor));3}4 5function leer(clave, defecto) {6 const texto = localStorage.getItem(clave);7 if (texto === null) return defecto;8 try {9 return JSON.parse(texto);10 } catch {11 return defecto;12 }13}14 15guardar("prefs", { tema: "oscuro", tamaño: 18 });16const prefs = leer("prefs", {});17document.querySelector("#info").textContent = `Tema ${prefs.tema}, letra ${prefs.tamaño}`;Fíjate en el caso del 0 y el false: si hubieras escrito JSON.parse(texto) || defecto, se perderían. Comparar con null distingue "no existe" de "existe y es falsy".