Como capturar um relatório de erro em menos de um minuto

Tudo o que quem programa precisa para reproduzir um erro está no seu ecrã enquanto o erro acontece: a página, a consola, os pedidos, o navegador em que está. Dez segundos depois o separador está fechado e nada disso resta, e é por isso que os relatórios de erro acabam como frases escritas de memória.

É assim que se captura o conjunto todo, com a extensão que construímos. Da primeira vez demora cerca de um minuto e depois uns segundos. Não é preciso conta nenhuma para apresentar um relatório.

Instalar

Chrome e navegadores Chromium, a partir da Web Store. Depois não há nada para configurar.

Capturar o erro

Vá à página que se está a portar mal e clique no ícone da extensão na barra de ferramentas.

Escolha captura de ecrã ou gravação. Uma captura de ecrã serve para tudo o que se vê de uma só vez: um layout partido, um total errado, uma mensagem de erro. Uma gravação serve para tudo o que traz dentro uma sequência ou um tempo: o botão que só funciona ao segundo clique, a roda que nunca para. A gravação para aos dez minutos e guarda tudo até esse ponto, por isso uma gravação longa nunca se perde por um limite que ninguém mencionou.

Desenhe sobre a captura de ecrã se ajudar. À mão livre, na cor que escolher. Um círculo à volta do número errado poupa um parágrafo inteiro a explicar qual é o número errado.

Acrescente uma descrição se tiver uma. É opcional, e vale os quinze segundos: o que esperava que acontecesse. É a única coisa que a captura não pode saber.

O que é capturado sem que faça nada

Esta é a parte que faz o relatório valer a leitura, e nada disto lhe pede que abra as ferramentas de programação:

• Navegador, versão, sistema operativo e tamanho do ecrã, que decidem se um defeito é de toda a gente ou só seu
• A saída da consola, incluindo o erro que foi escrito enquanto ninguém estava a olhar
• O registo de rede, com o estado e os tempos de cada pedido que a página fez, e um ficheiro HAR que pode transferir e abrir nas ferramentas de programação
• O que fez: os cliques, os campos preenchidos e as mudanças de página que levaram até ali, por ordem, que é o que transforma um relatório em passos para reproduzir

Há uma coisa para ligar de propósito. Marque a caixa dos corpos de resposta antes de gravar e a extensão liga o depurador do Chrome, para que o relatório leve o que o servidor de facto devolveu e não apenas a linha do pedido. Está desligada a menos que a ligue, e o Chrome mostra o seu próprio aviso durante todo o tempo em que está ligado.

Partilhar

Recebe um link. Cole-o onde o trabalho vive: o ticket, o pull request, a conversa no chat. Quem o abrir vê a captura e todos os separadores de contexto ao lado, sem conta e sem instalar nada.

Uma ligação de partilha é pública por predefinição. É isso que a torna fácil de enviar, e vale a pena saber antes de capturar uma página com dados pessoais de alguém ou um sistema interno à vista. Se o domínio é seu e tem um plano pago pode mudar isso: os relatórios podem começar privados, visíveis apenas para quem apresentou um e para a sua equipa, e qualquer relatório pode ser mudado de um estado para o outro depois.

Crie uma conta gratuita se quiser que os seus relatórios fiquem num só sítio e sem limite diário, e ver quando foram abertos. Apresentar um nunca o exige.

A parte que a ferramenta não faz

Uma captura é uma prova. Não é um relatório.

Não sabe o que esperava que acontecesse, nem se as duas coisas estranhas que reparou são um defeito ou dois, nem quanto isto importa em comparação com tudo o resto que está na fila. Isso é critério, e fica com a pessoa que estava lá, e é precisamente por isso que a caixa da descrição vale os quinze segundos apesar de todo o resto ser automático.

Se quiser a forma de um relatório que é corrigido em vez de devolvido com perguntas, o guia do relatório de erro tem-na, e o seu modelo é um ficheiro que pode guardar ao lado do seu gestor de incidências. Os dez erros mais comuns são a mesma lista vista do outro lado.

A versão curta

Instalar uma vez. Na página que se está a portar mal, clicar no ícone, escolher captura de ecrã ou gravação, dizer o que esperava, enviar o link. Os detalhes do navegador, a consola, o registo de rede e a sequência do que fez vão com ele, e a única parte que lhe resta é o critério, que sempre foi seu.