Saltar al contenido
JavaScript en el navegador

Guardar datos

Lección 8 de 1411 min4 ejercicios

El tema que eligió alguien, un carrito a medio armar, un borrador sin enviar: hay datos que conviene recordar entre visitas sin pasar por un servidor. El navegador ofrece varios lugares para guardarlos, cada uno pensado para un tamaño y un uso distintos.

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) y sessionStorage (por pestaña): síncronos, pequeños y solo de texto. Usa JSON.
  • Lee a la defensiva: null si no existe, y un try/catch alrededor de JSON.parse.
  • IndexedDB para datos grandes o estructurados; la Cache API para respuestas y archivos.
  • Las cookies viajan al servidor; las HttpOnly no 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

Elige una respuesta en cada pregunta.

  1. ¿Qué tipo de valor guarda localStorage?

  2. ¿Qué diferencia hay entre localStorage y sessionStorage?

  3. ¿Cuándo conviene IndexedDB en lugar de localStorage?

  4. ¿Es seguro guardar un token de sesión en localStorage?

Ordena la salida: Todo se vuelve texto

Un número, un objeto y una clave que no existe. Ordena lo que aparecería en la consola.

localStorage.clear();localStorage.setItem("visitas", 3);localStorage.setItem("usuario", { nombre: "Ana" }); console.log(typeof localStorage.getItem("visitas"));console.log(localStorage.getItem("usuario"));console.log(localStorage.getItem("no-existe"));console.log(localStorage.length);

Consola, de arriba abajo

  1. null
  2. string
  3. 2
  4. [object Object]

Detective: Un carrito que todavía no existe

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

Paso 1: toca la línea de código que causa el error.

Laboratorio: Preferencias que sobreviven

Escribe guardar y leer: cualquier valor con JSON, y un valor por defecto cuando no hay nada o está dañado.

app.jsse ejecuta mientras escribes

La página index.html

Consola del navegador

(escribe tu código: se ejecuta solo)

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)

    domina-js · JavaScript en español, gratis y paso a paso.