Transforme uma Gravação em um Relatório Acionável
Carregue a gravação de tela do bug. Reproduza-a e, cada vez que algo relevante acontecer, marque. O carimbo de data/hora é capturado, um quadro é retirado do vídeo naquele momento, e o passo é adicionado a uma lista numerada.
Escreva o resumo, o que você esperava e o que aconteceu em vez disso, depois copie tudo como Markdown para GitHub, marcação Jira ou texto simples. Os detalhes do navegador e da tela já vêm preenchidos.
A gravação nunca sai da sua máquina. Ela é reproduzida de um arquivo local e os quadros são desenhados no seu dispositivo, o que é importante quando o bug está em uma compilação não lançada ou na conta de um cliente.
Por Que Isso Não Usa IA Para Escrever o Relatório
Um modelo observando uma gravação de tela pode descrever o que vê. Ele não pode saber o que você esperava ver, e essa é a metade de um relatório de bug que decide se alguém pode agir sobre ele.
“Clicou em Confirmar, o painel da fatura estava vazio” é uma observação. Se isso é um bug, depende inteiramente do que deveria ter aparecido lá, e a única pessoa que sabe disso é você. Uma ferramenta que gera o comportamento esperado a partir de um vídeo está adivinhando e apresentando o palpite como uma descoberta, o que é pior do que deixar o campo em branco, porque uma expectativa errada e plausível envia um desenvolvedor para o caminho errado.
Então, a divisão aqui é deliberada. A ferramenta faz o trabalho mecânico que pode fazer exatamente: carimbos de data/hora, quadros, ambiente, formatação, numeração. Você fornece o julgamento. Isso leva cerca de um minuto e o resultado é um relatório sobre o qual ninguém precisa voltar a você.
As Três Coisas Que os Relatórios Geralmente Perdem
Tendo lido muitos relatórios de bugs incompletos, as mesmas lacunas se repetem, e todas as três são mecânicas, em vez de difíceis.
Carimbos de data/hora. Um relatório que diz “veja o vídeo anexado” faz o leitor assistir quatro minutos para encontrar o momento. Um passo que diz que aconteceu em 1:12 não.
Ambiente. Navegador, sistema operacional, tamanho da tela. Todo mundo sabe que deve incluir e quase ninguém o faz, porque significa abrir um painel de configurações enquanto você está pensando. Ele é lido do seu navegador aqui e já está preenchido no relatório, e você pode corrigi-lo.
Imagens estáticas. Um quadro no momento da falha é o que é escaneado em uma lista de vinte problemas. Retirar quadros de um vídeo manualmente é tedioso o suficiente para que as pessoas pulem essa etapa, então isso acontece automaticamente a cada passo que você marca.
O Que é Capturado, Precisamente
Cada passo marcado registra o tempo exato de reprodução e um quadro JPEG do vídeo naquele momento, redimensionado para manter o relatório leve. Você pode baixar os quadros para anexar ao problema.
O ambiente vem do navegador: seu nome e versão, o sistema operacional, o tamanho da tela com sua proporção de pixels e o tamanho da viewport. Os navegadores agora relatam menos sobre si mesmos do que costumavam, então alguns desses dados podem voltar como desconhecidos, e cada campo é editável em vez de bloqueado.
Nada é inferido dos pixels. A ferramenta não tenta ler textos de erro na tela ou adivinhar em qual elemento você clicou, porque fazer isso de forma não confiável é pior do que não fazer.
A Estrutura Que Preenche
A saída segue a forma que um relatório de bug assumiu, porque os rastreadores e as pessoas que os leem esperam por isso. Se você estava procurando por um modelo de relatório de bug, este é um que já vem preenchido em vez de um que você cola e fica olhando.
Resumo primeiro, em uma única linha, porque essa linha é o que alguém escaneia em uma lista de trinta problemas e decide se o seu será aberto hoje.
Em seguida, passos numerados com o código de tempo em cada um, comportamento esperado, comportamento real e o ambiente. Essa ordem não é decoração. Um leitor verifica os passos para ver se é reproduzível, o par esperado e real para ver se é realmente um bug, e o ambiente para ver se é o deles. Ocultar qualquer um desses custos uma viagem de ida e volta.
O que um modelo em branco não pode fazer é preencher-se, que é a parte que faz as pessoas pularem. Aqui, os passos, códigos de tempo, quadros e ambiente chegam preenchidos, e você escreve os três campos que uma ferramenta genuinamente não pode saber.
Antes de Gravar
O relatório é tão bom quanto a gravação, e dois hábitos fazem a diferença.
Comece de um estado conhecido. Uma gravação que começa no meio da sessão deixa o leitor a adivinhar o que veio antes, por isso os passos deixam de ser reproduzíveis. Comece numa tela de login, uma página nova, ou um ponto de partida descrito.
Limpe a tela de qualquer coisa que não deva ser partilhada. Tokens numa barra de URL, o nome de um cliente, um e-mail não relacionado noutra aba, uma chave de API num painel de ferramentas de desenvolvimento. Um relatório de bug é encaminhado, colado no chat e lido por pessoas fora da equipe, e uma gravação de tela carrega tudo o que estava na tela no momento. Esta ferramenta nunca carrega o vídeo, mas o relatório e os frames vão para onde os enviar.
O Que Não Faz
Não regista o problema. Não há ligação a GitHub, Jira ou qualquer outra coisa; você copia o relatório e cola-o onde pertence, o que também significa que o lê antes de qualquer outra pessoa.
Não capta logs, pedidos de rede ou saída da consola. Esses residem nas suas ferramentas de desenvolvimento e são extremamente importantes para alguns bugs. Anexe-os através de qualquer rota segura que a sua equipe já utilize, em vez de filmar uma consola.
E não diagnostica nada. Não lhe dirá a causa, qual componente está com falha, ou se isto duplica um problema existente. Coloca a evidência numa forma que alguém pode trabalhar, e esse é todo o trabalho.
Gravando o Bug em Primeiro Lugar
Se ainda precisar de capturar o problema, o gravador de tela grava uma aba, uma janela ou o ecrã inteiro no navegador. Para um bug que precisa narrar enquanto reproduz, grave com áudio e a explicação permanece anexada à evidência.
Dois vizinhos que vale a pena conhecer. Se quiser imagens individuais em vez de um relatório, o extrator de frames de vídeo extrai frames em intervalos. E se a gravação for longa e quiser a narração falada como texto, o gerador de transcrições transforma a narração em algo pesquisável.
