Cuando me toca depurar código y arreglar algún fallo, muchos compañeros o alumnos me preguntan ¿Cómo lo has encontrado? ¿Cuál es tu truco? ...Por mi parte, aplicar una serie de reglas muy básicas, me gustaría compartirlas con vosotros (dentro hilo...)
Lo primero, tómatelo como resolver un sudoku, no te amargues. Nuestra profesión va de esto, errores que te encuentras y rompecabezas, sino fueran difíciles o aleatorios no estarías aquí.
Cuando se te resiste un error, lo primero es dividir y aislar, comenta código y prueba cada pieza por separado, a veces te sorprende que el bug estaba en una tontería que no se te hubiese ocurrido mirar de primeras.
Busca exactamente el literal con el fallo y la librería que estés usando en tu buscador favorito, muchas veces te sorprenderá la de pobres diablos que han tenido tu mismo problema
Si usas una librería open source busca en la parte de Issues de github de ese proyecto, mira fecha de creación issue y si está cerrado. En más de una ocasión se introducen cambios que rompen y ves hilos en github que te pueden ayudar (mieddo los de: "abierto hace 4 horas...").
En el caso de que sea un fallo por una librería que se ha actualizado, prueba a bajar de versión a una estable y fíjala (quitarle el gorrito del package.json).
Cuando encuentres un bug de librería no solucionado y tengas que hacer un workaround acuerdate de añadir un comentario con enlace al issue por si en un futuro lo arreglan, así el próximo que llegue a tu código pueda eliminar el workaround sabiendo porqué.
Asegurate que no es algo relacionado con tu carpeta node_modules o tu máquina, borra node_modules borrar package.lock.json (o yarn.lock) y haz un install en limpio.
Acostúmbrate a buscar en inglés, es por probabilidad, hay más angloparlantes, más páginas con respuestas y más probable es que encuentres solución a tu error.
Haz una checklist de cosas de "perogrullo" a veces nos ofuscamos, y lo que hemos hecho es meter un typo o poner un método en un sitio que no es (esas son de las que duelen porque no te las esperas).
Sienta a un compañero contigo y reprodúcele el error y los pasos que estás dando... a veces sólo con contárselo te hace pop la cabeza, otras tu compañero puede ver algo que se te escapa.
En cuanto algo no te funcione bien, lo primero abre la consola de tu navegador y mira si hay algún mensaje de error o warning
Aprende bien a manejar las herramientas de depuración y profiling de tu navegador te pueden dar muchas pistas
Aisla tu problema en un codepen o un plunkr, y si pones una pregunta en stack overflow incluye tanto el código en la pregunta como el codepen con la reproducción del fallo
Para publicar en StackOverflow una pregunta, emplea tiempo en redactarla bien, añade ejemplos de código, y repro del fallo (te van a ayudar gratis, invierte tiempo en que tu pregunta este bien clara). Asegúrate antes que alguien no haya preguntado algo parecido…
Acuérdate que puedes depurar con ficheros minificados si les añades los ficheros map (de gran ayuda para depurar petes de bundles de producción).
Prueba en varios navegadores, aquí seguro que te llevas sorpresas desagradables pero necesarias, y sí... ya sabes en cual tienes que probar y te resistes a abrir...
Si el fallo te da en un entorno que no es tu local (producción, dev...) revisa variables de entornos y configuraciones, algo tan inocente como que no apunte a la api-rest correcta para ese entorno te puede fastidiar la tarde entera.
Cuando tu fallo este arreglado, invierte 5 minutos en comprender bien el porqué, y documéntalo para que otros compañeros no se den la torta.
Muchas gracias por haber llegado hasta aquí, y ¿Cual es tu "truco" para depurar? Sería genial que lo añadieras a este hilo.
