JavaScript de Cero a Experto / Testing con Vitest

Reto: la red de seguridad de Mi Bolsillo

Reto40 min60 XP

Le pusiste blindaje a "Mi Bolsillo" en el módulo 15; hoy le pones la red que verifica que ese blindaje funciona —y que seguirá funcionando cada vez que toques el código. Vas a escribir una suite de tests real: camino feliz, casos límite, un error que DEBE lanzarse, e inmutabilidad comprobada. Cuando termine en verde, tendrás lo que separa un script de un producto en el que se confía.

Reto

La red de seguridad de Mi Bolsillo

Media35 min60 XP(×2 sin mirar la solución)

Qué debes construir

Una suite de tests para el motor de "Mi Bolsillo" usando el mini-runner del módulo (mismo lenguaje que Vitest: test/expect/matchers). Cuando todos pasen, la salida debe ser EXACTAMENTE:

terminal

✓ total: suma los valores de varios gastos

✓ total: una lista vacía da 0

✓ agregar: devuelve una lista NUEVA (inmutable)

✓ agregar: no muta la lista original

✓ agregar: lanza si el valor no es positivo

✓ porCategoria: agrupa y suma por categoría

---

6 pasaron, 0 fallaron

Se te entrega el motor puro (no lo cambies) y el mini-runner. Tu trabajo es escribir los seis test:

total camino feliz: calcularTotal de tres gastos da su suma.
total borde vacío: calcularTotal([]) da 0 (el caso que rompe un reduce mal escrito).
agregar inmutable — lista nueva: agregarGasto(lista, gasto) devuelve un array DISTINTO al original (toBe con false sobre la identidad, o comprobando length).
agregar inmutable — no muta: tras llamar agregarGasto, la lista original conserva su length intacto.
agregar que lanza: agregarGasto con un gasto de valor: -5 LANZA (usa un try/catch dentro del test, o un helper esperarError).
porCategoria: agrupa los gastos y suma por categoría, comparando el objeto resultado con toEqual.

Reglas

No modifiques el motor: si un test falla, el bug está en tu test (o descubriste un bug real —avísalo mentalmente).
Cada test prueba UN concepto y tiene nombre descriptivo (ya te damos los nombres exactos arriba).
Para el test que verifica un throw, recuerda: la comprobación es "¿lanzó?", no "¿qué devolvió?".
Objetos y arrays se comparan con toEqual; identidad y primitivos con toBe.

35:00

Cuando estés listo, arranca el reloj.

Lo que esta suite ejercita —y por qué cada test gana su lugar:

El borde vacío es obligatorio. El test de calcularTotal([]) no es relleno: es el primer estado de todo usuario nuevo, y el que rompe un reduce sin valor inicial. Un motor sin ese test es un accidente esperando la fecha.
La inmutabilidad se AFIRMA, no se asume. Dos tests la cercan: que la función devuelva algo nuevo Y que la original no cambie. Juntos garantizan el contrato del módulo 12 —y ese contrato es lo que hace predecible tu app (y feliz a React, cuando llegues).
Testear que ALGO FALLA es tan importante como que algo funcione. El test del throw verifica el blindaje del módulo 15: la función se niega correctamente ante basura. Un validador sin un test que lo vea rechazar no está probado.

En Vitest de verdad, esta misma suite usaría describe("Mi Bolsillo", ...) con it(...), expect(nueva).not.toBe(base) para la identidad, expect(() => agregarGasto(...)).toThrow() para el error, y correría con pnpm test en modo watch. Cambia el mini-runner por Vitest y no tocas ni una línea de tus afirmaciones —esa es la prueba de que aprendiste el concepto, no solo una herramienta.

Autoevaluación de testeador: ¿tienes al menos un test de BORDE (el vacío)? ¿uno que verifica un throw? ¿la inmutabilidad está afirmada por DOS tests (nueva + no-muta)? Rompe el motor a propósito —haz que agregarGasto use .push en vez de spread— y mira cuáles tests se ponen rojos: si tu red es buena, atrapa el bug al instante. Esa red, corriendo sola en cada cambio, es lo que te va a dejar dormir tranquilo cuando trabajes en código que importa.

Qué sigue

Cierras el arsenal del ingeniero: errores, debugging y testing. Solo queda un módulo, y es el más emocionante —el 17: proyectos completos y diez retos tipo entrevista (de FizzBuzz a tu propio debounce). Ahí juntas los diecisiete módulos en cosas que puedes enseñar en un portafolio. La recta final del supercurso de JavaScript.