Um gravador de tela com logs de console, incluindo os erros de antes de você gravar
Atualizado em
O Midge é um gravador de tela com logs de console. Enquanto você grava a tela ou tira um screenshot no Chrome, ele captura toda mensagem de console que a página produz, do console.log a exceções não tratadas e promise rejections não tratadas, com stack traces, e alinha tudo com o vídeo. Como o Midge mantém um buffer contínuo da saída recente do console, um erro que disparou antes de você apertar gravar continua no report.
Essa segunda parte é o que falta na maioria dos bug reports. Quando você percebe que algo quebrou, o erro já passou numa janela do DevTools que ninguém tinha aberto. O Midge elimina o passo "dá para reproduzir com o console aberto?".
O que é capturado
Todos os níveis do console
O Midge grava chamadas de log, info, warn, error e debug com os timestamps e os valores passados a elas. Warnings importam mais do que se imagina: um warning de key do React ou um aviso de deprecação logado logo antes de um crash muitas vezes é a verdadeira pista.
Erros não tratados
Exceções que ninguém captura nunca passam pelo console.error. Elas sobem até a janela e o navegador as imprime em vermelho. O Midge escuta essas também, então um crash num event handler aparece mesmo que a sua aplicação não tenha log nenhum.
Promise rejections não tratadas
Uma promise rejeitada sem .catch() é uma das falhas silenciosas mais comuns nos front-ends modernos. Um botão "não faz nada" porque um fetch foi rejeitado e ninguém tratou. O Midge grava essas rejections e o motivo que elas carregam.
Stack traces
Para erros, o Midge salva o stack trace que o navegador informa. Uma entrada típica é assim:
Uncaught (in promise) TypeError: Failed to fetch
at submitOrder (orders.js:88:15)
at HTMLButtonElement.onClick (checkout.js:41:9)
Se o seu bundle de produção é minificado, o stack mostra nomes de arquivo e posições minificados, exatamente como o navegador informou, então deixe os seus source maps à mão quando for ler um report de produção.
Capturado antes de você apertar gravar
O Midge começa a escutar assim que cada página começa a carregar, antes de os scripts da sua aplicação rodarem, então até erros lançados durante a inicialização são capturados. Ele guarda na memória os últimos minutos de saída do console de cada aba aberta.
Quando você começa uma gravação de tela ou tira um screenshot, esse histórico recente é anexado. Na prática, isso significa que você pode trabalhar normalmente, notar que algo parece errado e só então decidir reportar. O erro vermelho de 20 segundos atrás continua na linha do tempo.
Algumas coisas sobre o buffer:
- Ele vive só na memória e é apagado quando a aba fecha.
- Nada sai do seu computador, a menos que você crie um report.
- Ele roda em páginas http e https comuns. Você pode adicionar sites em que o Midge nunca deve rodar, como o do seu banco ou um gerenciador de senhas.
Console e vídeo numa única linha do tempo
Toda gravação inclui logs de console, requisições de rede, ações do usuário e informações do dispositivo. No report, o console fica ao lado do vídeo, ordenado por tempo. Assista ao momento em que o modal não abre e o TypeError correspondente está bem ali, poucas linhas abaixo do clique que o disparou.
Erros combinam naturalmente com a atividade de rede. Um 500 de /api/orders seguido de Cannot read properties of undefined conta a história inteira: o servidor falhou e o cliente não tratou a falha. Leia mais na página de logs de rede.
Segredos na saída do console
Devs logam coisas que não deveriam, principalmente durante o debug: um token, um objeto de usuário inteiro, uma URL de requisição com uma API key na query string. O Midge aplica ao texto do console as mesmas regras de ocultação que usa para os dados de rede. Senhas, números de cartão, tokens e cookies são ocultados no seu navegador antes que qualquer coisa saia do seu dispositivo.
Por exemplo, esta linha:
auth ok: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MiJ9.abc123 for [email protected]
aparece no report assim:
auth ok: [REDACTED] for j***@acme.com
A lista completa de regras, e o que a ocultação não pega, está na página de ocultação.
Midge versus exportar o console à mão
Você mesmo pode salvar a saída do console pelo Chrome DevTools; o nosso guia sobre como exportar logs de console no Chrome mostra o passo a passo. Funciona, mas tem lacunas. O DevTools precisa estar aberto antes de o erro acontecer, a exportação é texto puro sem o vídeo e nada remove os segredos dela. Se você exportar logs ou um arquivo HAR manualmente, passe o HAR pelo sanitizador de HAR gratuito antes de anexá-lo a um ticket.
Com o Midge, o console é capturado com ou sem o DevTools aberto, fica sincronizado com o que você viu e é ocultado antes do upload.
Quem lê esses logs
Testers de QA param de colar stack traces pela metade nos tickets. Agentes de suporte podem anexar a saída real de um erro a uma escalação sem saber o que é um console. Devs recebem o erro exato, o stack e as chamadas de rede ao redor num só lugar. Se esse é o seu papel, veja Midge para devs.
O Midge é grátis: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água.
Perguntas frequentes
- Quais mensagens de console o Midge captura?
- Todos os cinco níveis: log, info, warn, error e debug. Ele também grava exceções não tratadas e promise rejections não tratadas, que nunca passam pelo console.error, junto com os stack traces.
- O Midge consegue capturar um erro que aconteceu antes de eu começar a gravar?
- Sim. O Midge guarda na memória os últimos minutos de saída do console de cada aba, então uma gravação ou um screenshot feito logo depois de um erro ainda o contém. O buffer é apagado quando você fecha a aba e nunca sai do seu dispositivo, a menos que você crie um report.
- Segredos nas mensagens de console são ocultados?
- Sim. JWTs, números de cartão, formatos conhecidos de API key, chaves privadas e parâmetros de URL sensíveis são removidos do texto do console, e e-mails e telefones internacionais ficam parcialmente mascarados.
- Preciso abrir o DevTools?
- Não. O Midge captura o console sem o DevTools aberto, e quem abre o seu report vê as mensagens ao lado do vídeo.