Clase 01 · Módulo 12
Depurar con método
Depurar con método
Qué logras en esta clase
Pasas de «no funciona» a saber qué falló, dónde y por qué, con un método que se repite igual en cada error.
- Lees una pantalla de error y su pila de llamadas.
- Usas el menú de desarrollo y React Native DevTools.
- Entregas a Claude Code un error que puede resolver.
- Reproduces en tu computador una falla que solo aparece en la versión final.
02
Un error es un mensaje, no un misterio
Casi todo error dice qué pasó y en qué línea. Depurar es aprender a leer esa información antes de tocar el código.
03
Dónde aparece la información de un error
| Lugar | Qué muestra |
|---|---|
| Pantalla de error en la app | Mensaje y pila de llamadas |
Terminal donde corre npx expo start | Registros y errores de compilación |
| React Native DevTools | Consola, red, pausas en el código |
| Registros nativos del teléfono | Caídas que JavaScript no alcanza a ver |
Empieza siempre por los dos primeros: resuelven la mayoría de los casos.
04
Cómo leer una pantalla de error
- Lee el mensaje completo, palabra por palabra.
- Baja por la pila de llamadas (la lista de funciones que se estaban ejecutando).
- Busca la primera línea que apunta a un archivo tuyo, no a
node_modules. - Anota archivo y número de línea.
- Abre esa línea en VS Code y mira qué valor podía venir vacío o con otro tipo.
05
Un error leído paso a paso
TypeError: Cannot read property 'nombre' of undefined
at TarjetaPedido (src/components/TarjetaPedido.tsx:14)
at renderItem (src/app/pedidos.tsx:32)
at FlatList (node_modules/react-native/...)06
La línea que importa
La línea útil es la primera que pertenece a tu código. Las de librerías casi nunca son la causa: son el lugar donde tu dato malo explotó.
07
Abrir el menú de desarrollo
El menú de desarrollo es un panel que trae tu development build (visto en el módulo 3).
| Situación | Cómo se abre |
|---|---|
| Desde la terminal de Expo | Tecla M |
| Teléfono Android o iPhone sin cable | Agitar el teléfono |
| Emulador de Android | Ctrl + M |
| Simulador de iOS (solo Mac) | Cmd + D |
08
Qué trae el menú de desarrollo
- Reload: recarga la app completa.
- Fast Refresh: activa o desactiva la recarga automática al guardar.
- Open DevTools: abre React Native DevTools.
- Toggle element inspector: toca un elemento y muestra qué componente es.
- Toggle performance monitor: memoria y cuadros por segundo (lo usas en la clase 5).
09
React Native DevTools: abrirlo y qué trae
Con la app corriendo, presiona J en la terminal de Expo. Se abre una ventana con pestañas:
| Pestaña | Para qué |
|---|---|
| Console | Ver registros y ejecutar código |
| Sources | Poner pausas en una línea |
| Network | Ver cada petición a internet |
| Components | Ver props y estilos de un componente |
| Memory | Uso de memoria de JavaScript |
| Profiler | Grabar qué se redibuja |
10
Pausar el código en una línea
Un punto de interrupción (breakpoint) detiene la app justo antes de una línea.
- En la pestaña Sources, abre tu archivo.
- Haz clic en el número de la línea sospechosa.
- Repite la acción en la app: se detiene ahí.
- Mira el valor real de cada variable.
- Reanuda la ejecución.
11
Registros con console.log, bien usados
console.log escribe un valor en la terminal y en la pestaña Console. Sirve para confirmar que una línea se ejecuta y con qué dato.
console.log('[pedidos] respuesta', pedidos.length, error);12
El método, en cinco pasos
Saltarse un paso es lo que convierte un error de diez minutos en uno de toda la tarde.
13
Paso 1: reproducir
Escribe la secuencia exacta que provoca el error: pantalla, acción, dato ingresado, usuario, plataforma.
- Si falla siempre, ya tienes cómo comprobar el arreglo.
- Si falla a veces, busca qué cambia: red lenta, usuario sin datos, primera apertura.
14
Paso 2: aislar
Reducir el espacio donde puede estar la causa.
- Pregúntate qué fue lo último que cambió.
- Revisa con Git si la versión anterior funciona (módulo 3, clase 7).
- Desactiva piezas de a una: una consulta, un componente, una librería.
- Cuando el error desaparece, la causa está en lo último que quitaste.
15
Una cosa a la vez
Cambia una sola cosa y vuelve a probar. Con tres cambios juntos, no sabrás cuál arregló el error ni cuál creó el siguiente.
16
Qué le entregas a Claude Code
Claude resuelve bien un error cuando recibe lo mismo que necesitaría una persona:
- El mensaje y la pila completos, copiados como texto.
- Los pasos para reproducirlo.
- Qué esperabas que pasara y qué pasó.
- Qué cambió desde la última vez que funcionó.
- Plataforma: Android o iPhone, emulador o teléfono real.
17
El mismo error, pedido de dos formas
| Pedido | Resultado probable |
|---|---|
| «La lista de pedidos no funciona, arréglala.» | Claude adivina y cambia varios archivos |
| «Al abrir Pedidos con un usuario sin pedidos aparece este error: (pila pegada). Antes de cambiar nada, dime la causa.» | Diagnóstico acotado y un cambio pequeño |
18
Pide la causa antes que el arreglo
- Pide que explique por qué ocurre, citando archivo y línea.
- Pide cómo comprobar esa causa (un registro, una pausa).
- Compruébala tú.
- Recién entonces pide el cambio mínimo que la corrige.
- Revisa el diff como aprendiste en el módulo 4, clase 6.
19
Funciona en desarrollo y falla en la versión final
La versión final se compila distinto: el código va reducido y sin las ayudas de desarrollo. Para acercarte a ese modo en tu computador:
npx expo start --no-dev --minify20
Cuando la app se cierra sin mostrar nada
Una caída nativa no muestra pantalla de error. Se lee en los registros del sistema.
| Plataforma | Cómo verlos |
|---|---|
| Android | adb logcat con el teléfono o emulador conectado |
| iPhone, con Mac | App Consola de macOS, eligiendo el dispositivo |
| iPhone, sin Mac | Reportes de caídas de la tienda o un monitor de errores (clase 6) |
21
Errores comunes al depurar
- Leer solo la primera línea del error y saltarse la pila.
- Pegarle a Claude una captura recortada en vez del texto completo.
- Probar arreglos al azar sin haber reproducido el error.
- Dejar registros de depuración en el código que se publica.
- Culpar a la librería antes de revisar el dato que tú le entregas.
22
Lo que te llevas
- Todo error tiene mensaje, archivo y línea: se lee antes de tocar nada.
- La primera línea de tu código en la pila es el punto de partida.
- Tecla
Mabre el menú de desarrollo yJabre React Native DevTools. - Reproducir, aislar, suponer, probar y confirmar, de a un cambio.
- A Claude se le pide primero la causa y después el arreglo.
23
Hazlo ahora
Diez minutos, en tu proyecto:
- Provoca un error a propósito: lee una propiedad de una variable vacía.
- Ubica tu archivo y tu línea en la pila.
- Abre React Native DevTools con
Jy pon una pausa en esa línea. - Mira el valor real de la variable.
- Pide a Claude Code solo la causa y compárala con lo que encontraste.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026