Cómo leer un mensaje de error sin entrar en pánico

Mario Rojas

7 de octubre de 20261 min de lectura

Al empezar, un error en rojo me bloqueaba. Hoy sé que el mensaje casi siempre dice exactamente qué pasó; solo hay que leerlo con método.

1. Lee la primera línea completa

text

TypeError: Cannot read properties of undefined (reading 'name')

Tipo: TypeError, usaste algo de una forma que su tipo no permite.
Qué: intentaste leer .name de algo que es undefined.

Ya sabes qué buscar: una variable que esperabas que fuera un objeto, pero no lo es.

2. Busca tu archivo en el stack trace

text

    at UserCard (components/UserCard.tsx:12:24)
    at renderWithHooks (react-dom.development.js:...)
    at ...

Ignora lo que viene de node_modules. La primera línea con tu archivo es donde empezar: UserCard.tsx, línea 12.

3. Pregúntate "¿qué valor tenía?"

TSX

<p>{user.name}</p>

Si user es undefined, ¿por qué? ¿Los datos aún no llegaron? ¿La API devolvió otra forma? Un console.log(user) justo antes resuelve la duda en segundos.

4. Errores que se repiten mucho

Mensaje	Suele significar
`Cannot read properties of undefined`	Los datos no llegaron o tienen otra forma
`is not a function`	Importaste mal o el valor no es lo que crees
`CORS policy`	El backend no permite tu origen
`404 Not Found`	La URL está mal escrita
`Unexpected token '<'`	Esperabas JSON y llegó HTML (otra página de error)

5. Busca el mensaje exacto

Copia la parte genérica del error (sin tus nombres de variables) y búscala. Casi seguro alguien ya tuvo el mismo problema.