Reporte de bugs para desarrolladores: las pruebas que habrías reunido tú mismo
Actualizado
El reporte de bugs para desarrolladores funciona mejor cuando el reporte contiene lo que habrías reunido tú mismo: el error de consola con su stack trace, la petición fallida con su cuerpo, los pasos que llevaron hasta ahí y el navegador en el que ocurrió. Midge captura todo eso automáticamente desde una pestaña de Chrome, lo alinea con el vídeo en una misma línea de tiempo y oculta los secretos antes de subirlo, así que el reporte se puede pegar sin riesgo en un ticket, una pull request o un chat de IA.
Cada grabación incluye logs de consola, peticiones de red, acciones del usuario y datos del dispositivo. Eso significa menos mensajes de «¿me puedes mandar la consola?» y más bugs corregidos a la primera lectura.
Qué recibes en un reporte
Una sola línea de tiempo
El vídeo está junto a un panel con los mensajes de consola, las peticiones de red y las acciones del usuario, todo ordenado por tiempo. Ves el clic en Save y justo ahí está el PATCH /api/projects/88 que vino después, con el Uncaught TypeError unos milisegundos después de que llegara la respuesta. No tienes que reconstruir la secuencia a partir de tres adjuntos.
Consola con stack traces
Todos los niveles, de debug a error, más las excepciones no capturadas y las promesas rechazadas sin gestionar, con sus stacks. Midge empieza a escuchar en cuanto se carga la página, así que los errores de arranque están incluidos, y mantiene un búfer circular, así que los errores de antes de que quien prueba pulsara grabar siguen ahí. Más detalles en la página de logs de consola.
Detalle de red
Las peticiones fetch y XHR llegan con cabeceras, cuerpos de petición y de respuesta, códigos de estado y tiempos. Los mensajes de WebSocket se graban en ambas direcciones. El resto de recursos muestra estado, tamaño y tiempo. En GraphQL, cada petición muestra el nombre de su operación, y las respuestas 200 que llevan un array errors se marcan, porque un filtro por estado se las saltaría. Más en la página de logs de red.
Datos del dispositivo
Navegador y versión, sistema operativo, tamaño de la ventana, idioma, zona horaria y URL. Suficiente para montar el mismo entorno, o para darte cuenta de que el bug solo ocurre con la configuración regional alemana.
Copiar como cURL
Cualquier petición se puede copiar como comando cURL y ejecutar desde tu terminal:
curl 'https://staging.acme.dev/api/projects/88' \
-X PATCH \
-H 'Content-Type: application/json' \
-H 'Authorization: [REDACTED]' \
--data-raw '{"name":"Q4 roadmap","archived":null}'
La cabecera Authorization ocultada es intencionada. Pon un token de tu propio usuario de prueba y estarás reproduciendo exactamente la misma petición sin que nadie comparta una sesión activa. Si quieres inspeccionar un token de tu propio entorno, el decodificador JWT gratuito muestra sus claims y su caducidad sin enviarlo a ningún sitio.
Descargar un HAR ocultado
Cuando necesitas el log de red completo, para una cuestión de rendimiento o para el equipo de soporte de un proveedor de API, descárgalo como archivo HAR. El archivo contiene los datos ocultados. Ábrelo en el visor HAR gratuito o en cualquier herramienta que lea HAR. Si trabajas con un HAR que alguien exportó directamente desde DevTools, lee cómo eliminar datos sensibles de un archivo HAR antes de reenviarlo.
Ocultación para que los reportes se puedan pegar sin riesgo
Los reportes de bugs se pegan en todas partes: tickets, hilos de Slack, descripciones de pull requests, chats con asistentes de código. Las contraseñas, números de tarjeta, tokens y cookies se ocultan en tu navegador antes de que nada salga de tu dispositivo. Eso incluye:
- las cabeceras
Authorization,CookieySet-Cookie, y cualquier cabecera con token, secret, session o auth en su nombre, - parámetros sensibles de la URL como
access_token,codeysignature, - campos del cuerpo como
password,otp,cvvyclient_secret, - JWT, números de tarjeta válidos según Luhn, claves privadas y claves de API de Stripe, AWS, GitHub, Slack, Google, OpenAI y Anthropic.
Los IDs de petición y otros valores de aspecto aleatorio se conservan a propósito, porque los necesitas para encontrar los logs del servidor correspondientes. La ocultación funciona con reglas; si tu app tiene sus propios campos secretos, añádelos a la lista de tu espacio de trabajo. Las reglas completas están en la página de ocultación.
Trabajar con agentes de código
Midge tiene un servidor MCP en https://midge.dev/mcp, así que Claude Code, Cursor y otros agentes pueden leer directamente la consola, la red y las acciones de un reporte. Pega el enlace del reporte en el chat y el agente obtiene lo que necesita con herramientas de solo lectura como get_console, get_network y get_user_actions. Inicia sesión a través de tu navegador o usa un token de Settings › Account › AI assistants. Aun así, puedes copiar la petición fallida como cURL o adjuntar el HAR ocultado. En cualquier caso, los datos ya están limpios.
Conseguir mejores reportes de tu equipo
La mejor herramienta sigue dependiendo de lo que captura la gente. Comparte nuestra guía sobre cómo escribir un reporte de bug con quienes prueban y con soporte, y recomiéndales el grabador de pantalla. Midge es gratis: grabaciones ilimitadas, vídeos de hasta 15 minutos y sin marca de agua, así que nadie tiene que racionar las grabaciones.
Preguntas frecuentes
- ¿Qué ve un desarrollador al abrir un reporte de Midge?
- El vídeo o la captura, con los mensajes de consola, las peticiones de red, las acciones del usuario y los datos del dispositivo al lado, ordenados por tiempo. Las peticiones muestran cabeceras, cuerpos, códigos de estado y tiempos.
- ¿Puedo volver a lanzar una petición fallida?
- Sí. Cualquier petición capturada se puede copiar como comando cURL. Las cabeceras de autenticación y las cookies están ocultadas, así que añades un token de tu propia cuenta de prueba antes de ejecutarla.
- ¿Es seguro pegar un reporte de Midge en un issue público o en un chat de IA?
- Midge elimina contraseñas, números de tarjeta, tokens, cookies y formatos conocidos de claves de API antes de subir nada. La ocultación funciona con reglas, así que revisa lo que sea poco habitual, pero los secretos comunes ya no están.
- ¿Puedo usar Midge para mi propia depuración?
- Sí. Grabar un bug que has encontrado tú es una forma rápida de pasárselo a un compañero o de volver a él más tarde con los logs intactos.