Depurar es parte de programar
Nadie escribe código sin errores. Lo que distingue a quien tiene experiencia no es que no se equivoque, sino que encuentra los errores rápido. A ese proceso se le llama depurar (debugging), y tiene método.
Hay dos tipos de problemas:
- El programa se rompe: aparece un error en rojo. Es el caso fácil, porque el error te dice dónde mirar.
- El programa funciona, pero hace otra cosa: no hay error, solo un resultado incorrecto. Aquí tienes que investigar.
Leer el mensaje de error
Un error tiene tres partes que conviene leer, en este orden:
TypeError: Cannot read properties of undefined (reading 'toUpperCase')
at formatear (app.js:3:22)
at app.js:7:1
- El tipo (
TypeError): qué clase de problema es. - El mensaje: qué pasó. Aquí, se intentó usar
.toUpperCase()sobre algo que valeundefined. - El stack trace (la pila): dónde ocurrió. La primera línea es el lugar exacto: archivo
app.js, línea 3, columna 22, dentro de la funciónformatear. Las siguientes muestran quién la llamó.
Con eso ya sabes que en la línea 3 hay una variable que vale undefined cuando esperabas un string. La pregunta pasa a ser: ¿por qué vale undefined?
El método
- Reproduce el error con el caso más pequeño posible. Si falla con una lista de mil productos, prueba con uno.
- Formula una hipótesis: «creo que
usuariollega vacío». - Compruébala mirando los valores reales.
- Corrige y vuelve a probar, incluyendo los casos que antes funcionaban.
Cambiar cosas al azar hasta que funcione rara vez sirve, y cuando sirve, no sabes por qué.
console.log con intención
La herramienta más simple es mostrar valores en los puntos clave. Ponles etiquetas para saber qué estás viendo:
function calcularTotal(items) {
console.log("items recibidos:", items.length);
let total = 0;
for (const item of items) {
console.log("sumando", item.nombre, item.precio);
total += item.precio;
}
console.log("total final:", total);
return total;
}
Si item.precio aparece como "25" entre comillas, ya encontraste el problema: llega como texto y el += está concatenando.
Otras ayudas de la consola:
console.error(...)yconsole.warn(...)destacan el mensaje en rojo o amarillo.console.table(array)muestra un array de objetos como tabla en el navegador.typeof valorte confirma el tipo cuando dudas.
Cuando termines, borra los console.log de depuración.
El depurador
Los navegadores traen un depurador. En la pestaña Sources (o Fuentes) de las herramientas de desarrollo (F12) puedes hacer clic en el número de una línea para poner un punto de interrupción. Cuando el código llega ahí, se pausa y puedes:
- ver el valor de todas las variables en ese momento,
- avanzar una línea a la vez (step over),
- entrar en una función (step into).
También puedes escribir la palabra debugger; en tu código: si las herramientas de desarrollo están abiertas, la ejecución se pausa en esa línea.
Errores típicos
| Síntoma | Causa probable |
|---|---|
ReferenceError: x is not defined |
Nombre mal escrito, mayúsculas distintas o variable fuera de su ámbito. |
Cannot read properties of undefined |
Un valor no existe: un find sin resultado, una propiedad mal escrita, un índice fuera del array. |
| La condición siempre se cumple | Usaste = (asignar) en lugar de === (comparar). |
| Te falta o te sobra un elemento | Índices desfasados: <= en lugar de < al recorrer con length. |
La función devuelve undefined |
Olvidaste el return, o usaste llaves en una flecha sin return. |
"10" + 5 da "105" |
El valor llega como string: conviértelo con Number(). |
Los dos ejercicios de esta lección son código con errores reales. Ejecútalo primero tal cual, lee lo que pasa y después corrígelo.