Saltar al contenido

Un grabador de pantalla con logs de consola, incluidos los errores de antes de grabar

Actualizado

Midge es un grabador de pantalla con logs de consola. Mientras grabas la pantalla o haces una captura en Chrome, recoge todos los mensajes de consola que genera la página, desde console.log hasta las excepciones no capturadas y las promesas rechazadas sin gestionar, con sus stack traces, y los alinea con el vídeo. Como Midge mantiene un búfer circular con la salida reciente de la consola, un error que saltó antes de que pulsaras grabar sigue estando en el reporte.

Esa segunda parte es lo que les falta a la mayoría de los reportes de bugs. Cuando te das cuenta de que algo se ha roto, el error ya ha pasado de largo en una ventana de DevTools que nadie tenía abierta. Midge elimina el paso de «¿puedes reproducirlo con la consola abierta?».

Qué se captura

Todos los niveles de consola

Midge registra las llamadas a log, info, warn, error y debug con su marca de tiempo y los valores que se les pasan. Los avisos importan más de lo que se cree: un aviso de key de React o una notificación de obsolescencia registrados justo antes de un fallo suelen ser la pista real.

Errores no capturados

Las excepciones que nadie captura nunca pasan por console.error. Suben hasta la ventana y el navegador las imprime en rojo. Midge también las escucha, así que un fallo en un manejador de eventos aparece aunque tu app no tenga ningún log.

Promesas rechazadas sin gestionar

Una promesa rechazada sin .catch() es uno de los fallos silenciosos más habituales en los front ends modernos. Un botón «no hace nada» porque un fetch se rechazó y nadie lo gestionó. Midge registra estos rechazos y el motivo que llevan.

Stack traces

En los errores, Midge guarda el stack trace que informa el navegador. Una entrada típica se ve así:

Uncaught (in promise) TypeError: Failed to fetch
    at submitOrder (orders.js:88:15)
    at HTMLButtonElement.onClick (checkout.js:41:9)

Si tu bundle de producción está minificado, el stack muestra los nombres de archivo y las posiciones minificados, tal como los informó el navegador, así que ten a mano tus source maps cuando leas un reporte de producción.

Capturado antes de pulsar grabar

Midge empieza a escuchar en cuanto cada página comienza a cargarse, antes de que se ejecuten los scripts de tu app, así que incluso los errores lanzados durante el arranque quedan capturados. Guarda en memoria los últimos minutos de la salida de consola de cada pestaña abierta.

Cuando empiezas una grabación de pantalla o haces una captura de pantalla, ese historial reciente se adjunta. En la práctica, puedes trabajar con normalidad, notar que algo no va bien y solo entonces decidir reportarlo. El error en rojo de hace 20 segundos sigue en la línea de tiempo.

Algunas cosas sobre el búfer:

  • Solo vive en memoria y se borra al cerrar la pestaña.
  • Nada sale de tu ordenador a menos que crees un reporte.
  • Funciona en páginas http y https normales. Puedes añadir sitios en los que Midge no debe ejecutarse nunca, como tu banco o un gestor de contraseñas.

Consola y vídeo en una sola línea de tiempo

Cada grabación incluye logs de consola, peticiones de red, acciones del usuario y datos del dispositivo. En el reporte, la consola aparece junto al vídeo, ordenada por tiempo. Mira el momento en que el modal no se abre y el TypeError correspondiente está justo ahí, unas líneas por debajo del clic que lo provocó.

Los errores encajan de forma natural con la actividad de red. Un 500 de /api/orders seguido de Cannot read properties of undefined cuenta toda la historia: el servidor falló y el cliente no gestionó el fallo. Lee más en la página de logs de red.

Secretos en la salida de consola

Los desarrolladores registran cosas que no deberían, sobre todo mientras depuran: un token, un objeto de usuario completo, una URL de petición con una clave de API en la query string. Midge aplica al texto de la consola las mismas reglas de ocultación que usa para los datos de red. Las contraseñas, números de tarjeta, tokens y cookies se ocultan en tu navegador antes de que nada salga de tu dispositivo.

Por ejemplo, esta línea:

auth ok: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MiJ9.abc123 for [email protected]

aparece en el reporte así:

auth ok: [REDACTED] for j***@acme.com

La lista completa de reglas, y lo que la ocultación no detecta, está en la página de ocultación.

Midge frente a exportar la consola a mano

Puedes guardar tú mismo la salida de consola desde Chrome DevTools; nuestra guía sobre cómo exportar los logs de consola en Chrome explica el proceso. Funciona, pero tiene huecos. DevTools tiene que estar abierto antes de que ocurra el error, la exportación es texto plano sin el vídeo y nada elimina los secretos. Si exportas logs o un archivo HAR a mano, pasa el HAR por el sanitizador de HAR gratuito antes de adjuntarlo a un ticket.

Con Midge, la consola se captura tanto si DevTools estaba abierto como si no, está sincronizada con lo que viste y se oculta lo sensible antes de subirla.

Quién lee estos logs

Los testers de QA dejan de pegar stack traces a medias en los tickets. Los agentes de soporte pueden adjuntar la salida de error real a una escalada sin saber qué es una consola. Los desarrolladores tienen el error exacto, el stack y las llamadas de red de alrededor en un solo sitio. Si ese es tu rol, consulta Midge para desarrolladores.

Midge es gratis: grabaciones ilimitadas, vídeos de hasta 15 minutos y sin marca de agua.

Preguntas frecuentes

¿Qué mensajes de consola captura Midge?
Los cinco niveles: log, info, warn, error y debug. También registra las excepciones no capturadas y las promesas rechazadas sin gestionar, que nunca pasan por console.error, junto con sus stack traces.
¿Midge puede capturar un error que ocurrió antes de que empezara a grabar?
Sí. Midge guarda en memoria los últimos minutos de la salida de consola de cada pestaña, así que una grabación o captura hecha justo después de un error sigue conteniéndolo. El búfer se borra al cerrar la pestaña y nunca sale de tu dispositivo a menos que crees un reporte.
¿Se ocultan los secretos de los mensajes de consola?
Sí. Los JWT, los números de tarjeta, los formatos conocidos de claves de API, las claves privadas y los parámetros de URL sensibles se eliminan del texto de la consola, y los correos y los teléfonos internacionales se enmascaran a medias.
¿Tengo que abrir DevTools?
No. Midge captura la consola sin que DevTools esté abierto, y quien abre tu reporte ve los mensajes junto al vídeo.