Gerador de Relatórios de Bugs

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 importante acontecer, marque o momento. O timestamp é capturado, um quadro é extraído do vídeo naquele instante e a etapa entra em uma lista numerada.

Escreva o resumo, o que você esperava e o que aconteceu em vez disso, depois copie tudo como Markdown para o GitHub, marcação do 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 a partir de um arquivo local e os quadros são extraídos no seu dispositivo, o que é fundamental quando o bug ocorre em uma versã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 toda a diferença.

Comece a partir de um estado conhecido. Uma gravação que começa no meio de uma sessão faz com que o leitor precise adivinhar o que aconteceu antes, impedindo que as etapas sejam reproduzíveis. Comece em uma tela de login, em uma nova página ou em um ponto de partida definido.

Limpe da tela qualquer coisa que não deva ser compartilhada. Tokens na barra de URL, o nome de um cliente, um e-mail não relacionado em outra aba, uma chave de API no painel de ferramentas de desenvolvedor. Um relatório de bug é encaminhado, colado em chats e lido por pessoas de fora da equipe, e uma gravação de tela captura tudo o que estiver visível no momento. Esta ferramenta nunca faz upload do vídeo, mas o relatório e os quadros irão para onde você os enviar.

O que Ela Não Faz

Ela não abre a issue. Não há conexão com o GitHub, Jira ou qualquer outra ferramenta; você copia o relatório e o cola onde for apropriado, o que também significa que você pode revisá-lo antes de qualquer outra pessoa.

Ela não captura logs, requisições de rede ou saídas do console. Esses dados ficam nas ferramentas de desenvolvedor e são extremamente importantes para alguns bugs. Anexe-os por meio de qualquer canal seguro que sua equipe já utilize, em vez de filmar o console.

E ela não diagnostica nada. Ela não indicará a causa, qual componente está com defeito ou se isso duplica um problema existente. Ela apenas organiza as evidências de uma forma prática para que alguém possa trabalhar nelas, e esse é todo o seu papel.

Gravando o Bug em Primeiro Lugar

Se você ainda precisa capturar o problema, o gravador de tela grava uma aba, uma janela ou a tela inteira diretamente no navegador. Para um bug que você precisa narrar enquanto reproduz, grave com áudio para que a explicação fique associada à evidência.

Duas ferramentas complementares que vale a pena conhecer. Se você precisa de imagens individuais em vez de um relatório, o extrator de quadros de vídeo extrai quadros em intervalos. E se a gravação for longa e você quiser o passo a passo narrado em texto, o gerador de transcrição transforma a narração em conteúdo pesquisável.

Pergunte à Gravação Sobre o Bug

A verificação nesta página é executada no seu dispositivo e não requer conta. Para obter respostas sobre o que foi dito ou exibido na gravação, faça o upload para o ScreenApp. Clique em uma pergunta para abrir o ScreenApp pronto para perguntar.

No ScreenApp, clicar em um momento na transcrição leva o player para aquele ponto na gravação, para que você possa conferir qualquer resposta com a gravação.

O Que Cada Plano Faz Aqui

A ferramenta nesta página é gratuita e continuará gratuita. Uma conta serve para a etapa anterior ou para a etapa posterior a ela.