JavaScript de Cero a Experto / Manejo de errores y debugging

Reto: Mi Bolsillo blindado

Reto35 min60 XP

Tu app "Mi Bolsillo" funciona… mientras nadie meta datos raros. Pero el mundo real mete valores negativos, texto donde va un número y categorías que no existen. Hoy la blindas: errores personalizados que triajan cada falla, validación en el borde y mensajes que un humano entiende. El código que resiste el abuso es lo que separa un ejercicio de un producto.

Reto

Mi Bolsillo blindado

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

Qué debes construir

Un módulo de bolsillo con una jerarquía de errores propios y un "borde" que los maneja con dignidad. Al correr el guion de pruebas debe imprimir EXACTAMENTE esto:

terminal

✓ Registrado: Almuerzo ($ 18.000)

✓ Registrado: Cine ($ 25.000)

⚠️ Dato inválido: El valor debe ser un número positivo (recibí: -500)

⚠️ Categoría inválida: 'cripto' no es una categoría permitida

🔧 [dev] ValorInvalidoError en campo 'valor'

Total blindado: $ 43.000

Requisitos:

Jerarquía de errores: una clase base BolsilloError extends Error, y dos hijas: ValorInvalidoError y CategoriaInvalidaError. Cada una con su name correcto. ValorInvalidoError guarda además el campo que falló.
La factory crearBolsillo(): movimientos privados (#movimientos o closure), un getter total (con reduce), y agregar(nombre, valor, categoria) que:
- lanza ValorInvalidoError si valor no es un número > 0 (con campo: "valor"),
- lanza CategoriaInvalidaError si categoria no está en ["comida", "transporte", "ocio"],
- si todo va bien, guarda y devuelve el gasto.
El borde registrar(bolsillo, nombre, valor, categoria): envuelve el agregar en try/catch. En el catch usa instanceof para imprimir el mensaje de usuario correcto (⚠️ Dato inválido: o ⚠️ Categoría inválida:); si es un ValorInvalidoError, imprime ADEMÁS la línea técnica 🔧 [dev] ... con error.name y error.campo. Un error desconocido se re-lanza.
El guion: registra Almuerzo/18000/comida y Cine/25000/ocio (éxitos), luego intenta Mercado/-500/comida y Netflix/15000/cripto (fallos), y cierra imprimiendo el total (que NO incluye los fallidos).

Reglas

Los movimientos son privados de verdad (nadie los toca desde afuera).
La factory LANZA; el borde registrar es el único que atrapa.
Los mensajes de usuario no llevan jerga; la línea 🔧 [dev] sí.
Formatea los pesos con Intl.NumberFormat es-CO (sin decimales).

30:00

Cuando estés listo, arranca el reloj.

Las tres decisiones que este reto entrena:

La jerarquía de errores es el triaje. Al preguntar por el TIPO (instanceof) en vez de leer el mensaje, tu borde reacciona a cada falla con precisión y no se rompe si mañana cambias una palabra del texto. El name y el tipo son datos estables; el mensaje es para humanos.
Lanzar profundo, atrapar en la superficie. agregar no sabe nada de consola ni de mensajes de usuario: solo valida y lanza. Todo el manejo vive en registrar, el borde. Así la lógica de negocio queda limpia y testeable (justo lo que harás en el módulo 16).
Un error con datos vale más que un string. ValorInvalidoError lleva el campo que falló, así que el borde puede dar información técnica precisa al dev sin parsear texto —el germen de cómo Zod y las librerías serias reportan validaciones.

Nota el detalle del 🔧 [dev]: solo aparece para ValorInvalidoError porque es el que lleva campo. Ese doble reporte —mensaje humano arriba, detalle técnico abajo— es exactamente la traducción de la que hablamos en la lección 4: el borde habla dos idiomas a la vez.

Autoevaluación: ¿el total final es $43.000 (solo los dos éxitos)? ¿Si mueves la validación de categoría ANTES que la de valor, cambia qué error sale para Mercado? (debería: pruébalo y entiende por qué el orden es una decisión). ¿Puedes atrapar toda la familia con un solo if (error instanceof BolsilloError)? Si todo cuadra: acabas de blindar una app con las mismas técnicas —errores tipados, validación en el borde, doble audiencia— que usan las codebases de producción.

Qué sigue

Módulo cerrado: tu código ya no se rompe, avisa. Pero cada vez que lo tocas, lo pruebas a mano corriendo el guion y mirando la consola… ¿y si eso lo hiciera una máquina, sola, en un segundo, cada vez? Ese es el módulo 16: testing. Y arranca con una idea que te va a encantar —vas a construir tu propio expect antes de usar el de verdad.