Pular para o conteúdo

Uma extensão do Chrome para tirar print que mantém os logs anexados

Atualizado em

O Midge é uma extensão do Chrome para tirar print feita para bug reports. Você captura a parte visível de uma aba ou uma região selecionada, marca com setas, caixas, caneta, texto e desfoque, e compartilha com um único link. Diferente de uma ferramenta de screenshot comum, o Midge anexa os logs de console recentes da página, as requisições de rede, as ações do usuário e as informações do dispositivo, então a imagem chega com as evidências de que um dev precisa.

O Midge é grátis: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água. Screenshots contam como gravações, então você pode tirar e compartilhar quantos precisar.

Duas formas de capturar

Área visível

Um clique captura o que você vê na aba, sem a barra de ferramentas do navegador, a barra de favoritos ou outras janelas. Use quando o layout inteiro importa: uma página que renderiza com o tema errado, um grid quebrado, um estado vazio que aparece quando não deveria.

Região selecionada

Arraste um retângulo em volta da parte que está errada. Um recorte justo de um botão desalinhado ou de um rótulo cortado é mais fácil de ler do que a página inteira, em que o leitor precisa caçar o problema. Você ainda pode dar contexto na descrição, como em qual página estava e no que clicou.

Anotações que deixam o problema óbvio

Depois da captura, o Midge abre um editor simples:

  • Seta: aponte para o elemento exato. "Este aqui, não o do lado."
  • Caixa: enquadre uma área, por exemplo dois preços que deveriam ser iguais.
  • Caneta: circule ou sublinhe algo à mão livre.
  • Texto: adicione um rótulo curto direto na imagem, como "deveria dizer 3 itens".
  • Desfoque: esconda o nome de um cliente, um endereço de e-mail ou um número de conta antes de compartilhar.

Use poucas anotações, e específicas. Uma seta e um rótulo de três palavras costumam funcionar melhor do que cinco caixas sobrepostas.

Os logs vêm junto com o screenshot

Essa é a parte que uma ferramenta de screenshot comum não consegue fazer. O Midge escuta a atividade de console e de rede da página em segundo plano e guarda os últimos minutos na memória. Quando você tira um screenshot, esse contexto é anexado. Toda gravação inclui logs de console, requisições de rede, ações do usuário e informações do dispositivo. Um report com screenshot traz os mesmos dados.

Veja por que isso importa. Imagine um card de dashboard que mostra "NaN%" em vez de uma taxa de conversão. O screenshot mostra o sintoma. O log de rede anexado mostra a causa:

GET /api/metrics/conversion  200
{"visits": 0, "orders": 0, "rate": null}

O dev vê que a API retornou null para um dia com zero visitas e que o front-end dividiu por zero. É uma correção de cinco minutos em vez de um dia de vai e volta. Para mais detalhes, veja logs de rede e logs de console.

A captura em segundo plano fica no seu dispositivo. Ela vive na memória, é apagada quando você fecha a aba e só sai do seu computador quando você cria um report. Você também pode listar sites em que o Midge nunca deve rodar, como o do seu banco.

Privacidade nos screenshots

São duas camadas para pensar.

A imagem. O que você vê na tela vai parar no screenshot. Use a ferramenta de desfoque em dados pessoais antes de compartilhar. O desfoque automático de campos de senha e de cartão vale para gravações de aba, não para screenshots, então aqui o desfoque fica por sua conta.

Os logs. Senhas, números de cartão, tokens e cookies são ocultados no seu navegador antes que qualquer coisa saia do seu dispositivo. E-mails ficam parcialmente mascarados, então o dev ainda consegue saber qual conta de teste encontrou o bug. A lista completa de regras está na página de ocultação.

Screenshot ou vídeo?

Use um screenshot quando o bug aparece num único frame: texto errado, layout quebrado, um número errado, um ícone faltando. Use uma gravação de tela quando o bug depende de uma sequência de passos, de tempo ou de animação, como um menu que fecha antes de você conseguir clicar ou um formulário que é enviado duas vezes. Se algo estranho acabou de acontecer e você não estava preparado, o replay instantâneo consegue salvar as últimas dezenas de segundos, desde que você o tenha ativado para aquele site.

Compartilhamento

Cada screenshot ganha um link. Você decide quem pode abrir: qualquer pessoa com o link, os membros do seu workspace ou só você. Guarde numa pasta, por exemplo uma por release ou por sprint, para o seu time encontrar depois. Times e pastas são grátis.

Um bom bug report com screenshot

Um screenshot responde "o que está errado". A descrição deve responder "o que você esperava" e "como eu chego lá". Um exemplo curto:

Title: Order count shows 0 on the Orders tab after filtering by "Last 7 days"
Steps: Orders, set filter to Last 7 days, wait for the list to load
Expected: count matches the 12 rows in the list
Actual: count shows 0 (arrow in screenshot)

O nosso modelo de bug report e os exemplos de bug report têm mais padrões como este. E se um colega mandou um token de uma requisição e você quer ver o que tem dentro, o decodificador JWT gratuito lê o token no seu navegador, sem enviá-lo para lugar nenhum.

Perguntas frequentes

Posso capturar só uma parte da página?
Sim. Você pode capturar a área visível da aba ou arrastar para selecionar uma região. Selecionar só o componente quebrado deixa o screenshot fácil de ler.
Quais ferramentas de anotação estão incluídas?
Setas, caixas, uma caneta livre, rótulos de texto e uma ferramenta de desfoque. O desfoque é a que você usa para nomes, e-mails ou qualquer outra coisa que não deva aparecer na imagem.
Um screenshot inclui logs de console e de rede?
Sim. O Midge mantém na memória a atividade recente de console e de rede enquanto você navega, então um screenshot tirado depois de um erro ainda traz os logs de antes dele.
Os campos de senha são escondidos automaticamente nos screenshots?
O desfoque automático de campos de senha e de cartão vale para gravações de aba. Num screenshot, use a ferramenta de desfoque em tudo o que for sensível antes de compartilhar. Segredos nos logs, como tokens e cookies, são ocultados de qualquer forma.