BugCapturer v1.0.1 Funcionalidade de diagnóstico em detalhes

O que há de novo na V1.0.1

O BugCapturer V1.0.1 introduz um poderoso novo recurso: Coleta Automática de Diagnósticos Técnicos. Este recurso captura automaticamente erros de console e solicitações de rede falhadas quando você envia um relatório de bug, fornecendo aos desenvolvedores pistas de diagnóstico precisas que reduzem drasticamente os custos de reprodução de bugs.

Por que os diagnósticos são importantes

Quando você relata um bug, as informações mais valiosas nem sempre são visíveis na tela. Frequentemente, as pistas reais estão escondidas em:

Erros de console: Exceções JavaScript, avisos e mensagens de erro

Solicitações de rede falhadas: Chamadas de API retornando códigos de status 4xx/5xx

Sem essas informações, os desenvolvedores precisam reproduzir o bug eles mesmos, abrir o DevTools e procurar os erros relevantes. Isso pode levar minutos ou até horas.

Como funciona

Coleta de erros de console

Quando você marca "Incluir diagnósticos técnicos" e envia um relatório, o BugCapturer captura automaticamente até 10 registros de console de nível erro, incluindo:

Nível: Sempre "error" (não coletamos avisos ou informações)

Mensagem: O texto da mensagem de erro

Fonte: O arquivo, linha e coluna onde o erro ocorreu (ex. app.js:142:8)

Isso dá aos desenvolvedores a localização exata para começar a depuração.

Coleta de erros de rede

O BugCapturer também captura até 5 solicitações HTTP falhadas (código de status ≥ 400), incluindo:

URL: A URL da solicitação (com parâmetros sensíveis sanitizados)

Método: GET, POST, PUT, DELETE, etc.

Código de status: 404, 500, 403, etc.

Texto de status: "Not Found", "Internal Server Error", etc.

Design focado em privacidade

Construímos a coleta de diagnósticos com três princípios de privacidade:

1. Sanitização de URL

Parâmetros de URL sensíveis são automaticamente substituídos por *:

token, key, secret, password, auth, access_token, refresh_token, api_key, private_key, credential

Assim, https://api.example.com/data?token=abc123&user=john se torna https://api.example.com/data?token=*&user=john.

2. Opt-in do usuário

A caixa de seleção "Incluir diagnósticos técnicos" está marcada por padrão, mas os usuários podem desativar a qualquer momento. Se desmarcada, nenhum dado de diagnóstico é coletado.

3. Coleta única

Os diagnósticos são coletados apenas no momento em que você envia um relatório. Não há monitoramento em segundo plano, nenhum registro contínuo, nenhum acúmulo de dados. O que você vê é exatamente o que é enviado.

Detalhes de implementação técnica

Captura de erros de console

O BugCapturer se conecta ao método console.error do navegador no momento da ativação da extensão. Armazena erros em um buffer circular com no máximo 10 entradas, mantendo apenas os erros mais recentes.

Captura de erros de rede

Usando a API chrome.webRequest, o BugCapturer monitora solicitações de rede concluídas e filtra códigos de status ≥ 400. Apenas a URL sanitizada, o método e as informações de status são armazenados — sem corpos de solicitação ou resposta.

Fluxo de dados

O usuário ativa o BugCapturer

O monitoramento de console e rede começa

O usuário tira captura de tela, anota, preenche o formulário

O usuário clica em "Enviar e-mail"

Se os diagnósticos estiverem habilitados, os erros atuais são coletados

Todos os dados são empacotados no corpo do e-mail

O cliente de e-mail é iniciado com conteúdo pré-preenchido

Nenhum dado é enviado a nenhum servidor — tudo fica no e-mail

O que os desenvolvedores veem

Quando um desenvolvedor recebe um relatório do BugCapturer com diagnósticos, o corpo do e-mail inclui: Seção de erros de console:

Cada erro com sua mensagem e localização fonte

Até 10 entradas, as mais recentes primeiro

Seção de erros de rede:

Cada solicitação falhada com URL sanitizada, método e status

Até 5 entradas, as mais recentes primeiro

Este formato estruturado facilita a análise e identificação rápida da causa raiz.

Impacto

Feedback antecipado de usuários mostra:

60% de redução na comunicação de ida e volta "preciso de mais informações" em relatórios de bugs

Desenvolvedores podem começar a depurar imediatamente em vez de reproduzir primeiro

Relatórios de bugs mais precisos levam a correções mais rápidas

Conclusão

Os diagnósticos técnicos automáticos são uma extensão natural da missão do BugCapturer: tornar o relatório de bugs o mais rápido e eficaz possível. Ao coletar automaticamente o contexto técnico que os desenvolvedores precisam, eliminamos a parte mais demorada do processo de relatório de bugs — enquanto mantemos nosso compromisso com a privacidade e segurança de dados.