Bug report para desenvolvedores: as evidências que você mesmo teria coletado
Atualizado em
Bug report para desenvolvedores funciona melhor quando o report contém o que você mesmo teria coletado: o erro de console com o stack trace, a requisição que falhou com o body, os passos que levaram até ali e o navegador em que aconteceu. O Midge captura tudo isso automaticamente de uma aba do Chrome, alinha com o vídeo numa única linha do tempo e oculta segredos antes do upload, então o report pode ser colado com segurança num ticket, num pull request ou num chat de IA.
Toda gravação inclui logs de console, requisições de rede, ações do usuário e informações do dispositivo. Isso significa menos mensagens de "pode me mandar o console?" e mais bugs corrigidos já na primeira leitura.
O que vem num report
Uma linha do tempo
O vídeo fica ao lado de um painel com as mensagens de console, as requisições de rede e as ações do usuário, tudo em ordem cronológica. Você vê o clique em Save e, logo ali, o PATCH /api/projects/88 que veio em seguida, com o Uncaught TypeError poucos milissegundos depois de a resposta chegar. Você não precisa reconstruir a sequência a partir de três anexos.
Console com stack traces
Todos os níveis, de debug a error, além de exceções não capturadas e promise rejections não tratadas, com as stacks. O Midge começa a escutar enquanto a página carrega, então erros de inicialização entram, e mantém um buffer contínuo, então os erros de antes de o tester apertar gravar continuam lá. Detalhes na página de logs de console.
Detalhes de rede
Requisições fetch e XHR vêm com headers, bodies de requisição e de resposta, status codes e tempos. Mensagens de WebSocket são gravadas nas duas direções. Os outros recursos mostram status, tamanho e tempo. No GraphQL, cada requisição mostra o nome da operação, e respostas 200 que trazem um array errors são sinalizadas, já que um filtro por status deixaria essas passar. Mais na página de logs de rede.
Informações do dispositivo
Navegador e versão, sistema operacional, tamanho da janela, idioma, fuso horário e URL. O suficiente para montar o mesmo ambiente, ou para perceber que o bug só acontece com o idioma em alemão.
Copiar como cURL
Qualquer requisição pode ser copiada como comando cURL e rodada no seu 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}'
O header Authorization ocultado é proposital. Coloque um token do seu próprio usuário de teste e você reproduz exatamente a mesma requisição sem ninguém compartilhar uma sessão ativa. Se quiser inspecionar um token do seu próprio ambiente, o decodificador JWT gratuito mostra as claims e a expiração sem enviar o token para lugar nenhum.
Baixe um HAR ocultado
Quando você precisa do log de rede inteiro, para uma questão de performance ou para o suporte de um fornecedor de API, baixe-o como arquivo HAR. O arquivo contém os dados já ocultados. Abra no visualizador de HAR gratuito ou em qualquer ferramenta que leia HAR. Se você está trabalhando com um HAR que alguém exportou direto do DevTools, leia como remover dados sensíveis de um arquivo HAR antes de repassá-lo.
Ocultação para os reports poderem ser colados em qualquer lugar
Bug reports são colados em todo canto: tickets, threads no Slack, descrições de pull request, chats com assistentes de código. Senhas, números de cartão, tokens e cookies são ocultados no seu navegador antes que qualquer coisa saia do seu dispositivo. Isso inclui:
- os headers
Authorization,CookieeSet-Cookie, e qualquer header com token, secret, session ou auth no nome, - parâmetros de URL sensíveis como
access_token,codeesignature, - campos de body como
password,otp,cvveclient_secret, - JWTs, números de cartão válidos pelo algoritmo de Luhn, chaves privadas e API keys de Stripe, AWS, GitHub, Slack, Google, OpenAI e Anthropic.
Request IDs e outros valores com cara de aleatórios são mantidos de propósito, porque você precisa deles para achar os logs correspondentes no servidor. A ocultação funciona por regras; se a sua aplicação tem campos secretos próprios, adicione-os à lista do seu workspace. As regras completas estão na página de ocultação.
Trabalhando com agentes de código
O Midge tem um servidor MCP em https://midge.dev/mcp, então o Claude Code, o Cursor e outros agentes conseguem ler diretamente o console, a rede e as ações de um report. Cole o link do report no chat e o agente busca o que precisa com ferramentas só de leitura, como get_console, get_network e get_user_actions. Ele faz login pelo seu navegador ou usa um token de Settings › Account › AI assistants. Você também pode copiar a requisição que falhou como cURL ou anexar o HAR ocultado. De qualquer jeito, os dados já chegam limpos.
Reports melhores do seu time
A melhor ferramenta ainda depende do que as pessoas capturam. Compartilhe o nosso guia sobre como escrever um bug report com testers e com o suporte, e indique a eles o gravador de tela. O Midge é grátis: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água, então ninguém precisa economizar gravações.
Perguntas frequentes
- O que um dev vê ao abrir um report do Midge?
- O vídeo ou o screenshot, com as mensagens de console, as requisições de rede, as ações do usuário e as informações do dispositivo ao lado, em ordem cronológica. As requisições mostram headers, bodies, status codes e tempos.
- Dá para repetir uma requisição que falhou?
- Sim. Qualquer requisição capturada pode ser copiada como comando cURL. Headers de autenticação e cookies vêm ocultados, então você coloca um token da sua própria conta de teste antes de rodar.
- É seguro colar um report do Midge numa issue pública ou num chat de IA?
- O Midge remove senhas, números de cartão, tokens, cookies e formatos conhecidos de API key antes do upload. A ocultação funciona por regras, então revise qualquer coisa fora do comum, mas os segredos mais comuns já foram removidos.
- Posso usar o Midge para o meu próprio debugging?
- Sim. Gravar um bug que você mesmo encontrou é um jeito rápido de passá-lo a um colega ou de voltar a ele depois com os logs intactos.