
Minilição · Português
Como encontrar e corrigir erros no seu site no ar
Reproduza uma ação de visitante fornecida com defeito, peça a um assistente uma correção pontual e verifique a mesma ação após a alteração.
Para quem é esta lição?
Para quem quer encontrar e corrigir falhas vividas pelos visitantes. Você usará uma página quebrada fornecida; um assistente de programação pode alterar o código enquanto você descreve o problema e repete a ação.
Antes de começar
O site separado de prática fornecido e um assistente de programação. Um projeto Sentry de prática é opcional para a parte de monitoramento; envie apenas os erros fictícios fornecidos e não use dados privados de visitantes.
Tempo estimado: 19–31 min
Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. A configuração do provedor e a espera pela ingestão são adicionais. Uma chamada local de captura não prova que um alerta foi recebido.
O que você vai aprender
- Reproduza uma ação realmente quebrada em vez de verificar apenas o carregamento da página.
- Compartilhe contexto seguro suficiente para uma correção pontual pelo assistente.
- Verifique a ação corrigida e o estado relevante do monitoramento.
Etapa 1
Experimente a ação do visitante
Uma página pode abrir enquanto sua funcionalidade útil está quebrada.
Peça ao assistente para servir public por HTTP e abra a página. Acione “Find contact section”. A versão practice-R1 procura deliberadamente um alvo ausente, então o estado informa que Contact falhou.
Informe ao assistente o botão exato, o destino esperado e o resultado visível. A seção Contact pode existir enquanto o botão não chega a ela; só conferir que a página carrega não encontraria isso.
Um exemplo concreto
Um relato útil é: “Pressionei Find contact section em practice-R1. Esperava chegar à seção Contact, mas o estado disse Contact action failed.”
Use o exemplo fornecido de ação de contato quebrada num site de prática separado. Reproduza a falha do botão, identifique uma causa pontual e altere só o necessário. Ajude-me a repetir a mesma ação e comparar antes/depois. Se o monitoramento estiver ativo, use apenas erros fictícios e meu próprio projeto de prática; não envie dados privados de página ou formulário. Não considere um problema corrigido só porque foi marcado como resolvido.Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Encontre e corrija um erro do site no ar
Comece por uma ação do visitante que falhou e use o relatório para localizar a causa.
O monitoramento é útil quando liga um sintoma real a código que você consegue investigar. Esta página procura deliberadamente um elemento de contato inexistente, por isso a ação de contato falha.
Enviamos apenas um erro sintético fixo ao seu projeto Sentry. O relatório inclui uma identificação de versão e um local na pilha; o registro de incidente relaciona essas evidências ao que o visitante tentou fazer.
Exemplo resolvido
A página inicial carrega normalmente. Clicar em “Find contact section” (encontrar a seção de contato) falha porque o script procura #contact-missing, enquanto o HTML real tem id=contact.
Extra implementation exercise
Por que uma verificação HTTP 200 da página inicial não detecta este bug?
Mostrar uma solução comentada
O HTML pode carregar corretamente enquanto uma ação JavaScript posterior falha. Repita a tarefa de contato, não apenas a solicitação da página.
- Testa a interação afetada depois do carregamento da página.
- Distingue disponibilidade de funcionamento correto.
Erro comum
Declarar um recurso JavaScript saudável porque o servidor serve seu HTML.
Etapa 2
Colete apenas contexto seguro e útil
Dê provas ao assistente sem dados privados de visitantes.
Dê ao assistente os arquivos, a versão e o sintoma da etapa anterior. É suficiente para começar a inspecionar o exemplo local sem enviar texto real de formulários ou informações de conta de visitantes.
Se usar o Sentry opcional, configure só seu valor público de loader e ative o monitoramento antes de reproduzir o erro controlado. Confira o evento correspondente e seus dados. Um evento aparecer no Sentry é diferente de um alerta chegar à caixa de entrada.
Um exemplo concreto
O erro permitido fornecido é “Practice: missing contact target”. Um evento útil pode incluir a versão de prática e o local no código sem mensagem real de usuário, endereço de e-mail ou token de conta.
Sentry: carregador de navegador e inicialização personalizada
Experimente
Que contexto você compartilhará e que dados privados excluirá?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Eu compartilharia os arquivos practice-R1, a ação “Find contact section” e sua falha. Com monitoramento, procuraria “Practice: missing contact target” e a versão correspondente no projeto de teste. Excluiria e-mails, textos e tokens; o alerta por e-mail é outra verificação.
- Compartilha a ação fictícia reproduzível, a versão de prática e o contexto relevante dos arquivos.
- Exclui conteúdo real dos visitantes e distingue eventos recebidos de alertas entregues.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Envie um relatório de diagnóstico controlado
Colete o suficiente para investigar sem enviar conteúdo bruto do usuário.
Configure a URL pública do carregador conforme START-HERE.txt. O script define o callback de inicialização antes de carregar o SDK, desativa rastreamento e reprodução e usa uma lista de permissão beforeSend para este erro fixo de prática.
O evento de diagnóstico retornado exclui os dados da solicitação, os dados do usuário, os extras arbitrários e o histórico das ações anteriores ao erro (breadcrumbs). A consulta e o fragmento são removidos dos nomes de arquivo da pilha. Em um site real, revise todas as fontes de diagnóstico sensível; sendDefaultPii=false, sozinho, não garante que o texto livre ou as URLs não contenham informações pessoais.
O filtro beforeSend é estrito de propósito: só o texto sintético exato 'Practice: missing contact target' é enviado. As outras mensagens são descartadas. Se mudar o texto do erro, atualize a lista deliberadamente ou a ausência do evento é esperada. Não remova o filtro só para movimentar o painel; examine os dados permitidos em busca de informações indesejadas.
Se nenhum evento chegar, primeiro examine a mensagem fixa e a lista beforeSend em app.js. Um evento incompatível agora mostra uma mensagem local de evento filtrado; ele não é contado como enviado. O analisador de URL usa location.origin como base de nomes relativos e substitui um nome impossível de analisar por redacted em vez de encaminhar um original potencialmente sensível.
A opção documentada data-lazy="no" do carregador é definida por script.dataset.lazy="no"; ela pede para carregar o SDK completo antecipadamente. Os nomes de arquivo da pilha mantêm apenas origem e caminho HTTP(S) depois de remover consulta e fragmento. Esquemas não web são ocultados em vez de encaminhados intactos.
Exemplo resolvido
Uma mensagem fixa como “Practice: missing contact target” basta para este exercício. Enviar um objeto inteiro de formulário acrescentaria risco sem ajudar a identificar o destino DOM ausente.
Sentry: carregador de navegador e inicialização personalizada
Extra implementation exercise
Desativar dados pessoais padrão tornaria automaticamente seguro enviar mensagens arbitrárias de erro?
Mostrar uma solução comentada
Não. Revise os dados reais do evento e restrinja o que seu código envia. Informações pessoais podem aparecer em mensagens, URLs, breadcrumbs e extras mesmo sem a coleta padrão de dados pessoais.
- Reconhece que textos e URLs da aplicação ainda podem conter dados privados.
- Aplica ocultação e listas de permissão explícitas.
Erro comum
Tratar uma opção de privacidade como uma revisão completa dos dados enviados.
Etapa 3
Aplique uma correção pontual
Repita a ação exata que falhou após a alteração.
Peça ao assistente para comparar o destino do botão com a seção Contact existente. worked-solution/app.js contém a pequena correção; peça para aplicá-la e nomear a revisão corrigida practice-R2.
Abra practice-R2 atualizada e acione o mesmo botão. Deve chegar a Contact e mostrar “Contact section opened.” Só mudar a versão ou marcar o problema resolvido no Sentry não altera o comportamento do botão.
Um exemplo concreto
O script quebrado procura #contact-missing, mas o HTML define Contact em #contact. O assistente pode corrigir essa correspondência; você avalia usando o botão novamente.
Experimente
O que mudou e o que aconteceu quando você repetiu a ação original?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Na solução, o assistente troca o alvo ausente pela seção existente #contact e identifica practice-R2. O novo teste esperado é o mesmo botão chegar a Contact e mostrar “Contact section opened.” Um rótulo resolvido sem esse teste não comprova a correção.
- Relaciona a pequena correção de destino à seção Contact existente.
- Repete a mesma ação na versão atualizada e verifica o resultado visível ao usuário.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Relacione o relatório, corrija a causa e teste novamente
Um rótulo de problema resolvido não corrige o código.
Ative o monitoramento, provoque a falha sintética e localize o evento real na sua conta. Compare a versão e o local com o código fornecido. Se não chegar, examine carregamento, bloqueadores, configuração e entrega pela rede antes de supor que não houve erro.
Substitua o script por worked-solution/app.js, atualize a identificação de versão e repita a ação de contato. O destino correto deve aparecer na área visível. Marcar o problema como resolvido no painel não substitui essa verificação de comportamento.
A troca do arquivo é uma pequena representação de correção no laboratório. Em um site de prática hospedado, registre o app.js e a versão alterados em um commit, revise e implante essa revisão e depois teste a URL pública. Atualizar apenas o estado do problema ou o rótulo da versão não aplica a correção do seletor.
Exemplo resolvido
R1 falha com #contact-missing; R2 usa #contact. A evidência relevante de recuperação é a ação de contato funcionar na revisão corrigida.
Extra implementation exercise
O problema está marcado como resolvido, mas o script implantado ainda consulta #contact-missing. Ele foi corrigido?
Mostrar uma solução comentada
Não. Um estado do painel não muda o script. Implante a correção pelo processo de revisão e verifique a ação naquela revisão.
- Verifica o código e a revisão realmente implantados.
- Repete a ação que falhava.
Erro comum
Mudar o estado do problema em vez de publicar e verificar a correção.
Etapa 4
Conclua uma nota útil de incidente
Mantenha sintoma, correção e verificação conectados.
Complete incident-record.txt com a falha original, a pequena correção e o resultado da ação repetida na página atualizada. Se publicar a mudança de prática, confira essa versão publicada exata, não apenas o arquivo local.
Separe as observações opcionais: se o evento chegou ao Sentry, se configurou um alerta e se a notificação chegou. O registro deve explicar essa tarefa corrigida e qualquer lacuna, não afirmar que o site inteiro não tem erros.
Um exemplo concreto
Uma nota curta relaciona a falha Contact de practice-R1, a correção do alvo e o teste bem-sucedido de practice-R2. “Problema resolvido”, sozinho, omite o resultado do visitante.
Experimente
Materiais para começar
Os arquivos e conteúdos de teste estão incluídos. A verificação real exige sua própria conta, caixa de entrada ou domínio conforme os pré-requisitos. É possível inspecionar localmente; marque etapas reais não executadas como não testadas.
Apresente o registro do incidente e a verificação real da ação corrigida.
O que entregar Um breve registro de incidente com sintoma reproduzido, alteração delimitada e novo teste real bem-sucedido.
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro ilustrativo de incidente: Contact em practice-R1 informou falha; o assistente corrigiu o alvo; em practice-R2, o mesmo botão chegou à seção e mostrou sucesso. O evento fictício foi verificado separadamente no monitoramento de teste. Nenhuma regra de alerta foi configurada, então a entrega de notificação não foi testada. Isso cobre esse defeito Contact, não todos os erros futuros.
- Relaciona sintoma original, mudança pontual e teste real da mesma ação na versão identificada.
- Separa observações de evento/alerta do provedor e identifica qualquer cobertura ainda não testada.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Sua tarefa: escrever uma nota útil de incidente
Permita que a próxima pessoa entenda a causa e as evidências.
Preencha o registro com referência de evento sem dados sensíveis, ação afetada, local do código, causa raiz e teste bem-sucedido. Se configurar um alerta, verifique a notificação real separadamente da ingestão do evento.
Acrescente uma segunda falha sintética na sua cópia e repita o ciclo. Mantenha mensagens fixas e atualize a lista deliberadamente; não amplie o monitoramento enviando dados arbitrários de página ou formulário.
Exemplo resolvido
“Seletor ausente corrigido de #contact-missing para #contact; novo teste R2 passou” permite agir. “Sentry tinha um erro; resolvido” deixa a causa e a verificação desconhecidas.
O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.
Extra implementation exercise
Produza uma nota de incidente e prove que a ação corrigida funciona.
Mostrar uma solução comentada
Ative o carregador de prática configurado e provoque o erro sintético exato. Se mudar o texto, atualize a lista estrita intencionalmente; descartar uma mensagem não permitida é esperado. Examine o evento realmente recebido, sua versão, local e dados indesejados.
Aplique o script corrigido a public/app.js e mude RELEASE para practice-R2. Publique essa revisão pelo fluxo revisado e repita Find contact section na URL realmente implantada. Mudar apenas a versão ou o estado do problema não corrige o seletor.
Registre a ingestão do problema separadamente da entrega da notificação. O evento pode aparecer antes de um alerta configurado chegar; mantenha cada observação pendente até verificar. A nota de referência liga falha, local, mudança de seletor e novo teste visível ao usuário.
- Liga sintoma, versão e causa no código.
- Verifica o comportamento e mantém separadas as afirmações de entrega de evento e notificação.
Erro comum
Supor que um painel vazio prova que os usuários não encontram erros.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como publicar seu site pelo GitHub
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como enviar e-mails automáticos pelo seu site
- Como salvar envios de formulário em um banco de dados
- Como permitir que as pessoas entrem no seu site
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como fazer um chatbot responder com base no seu conteúdo
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como adicionar outro idioma ao seu site
- Como ajudar o Google a encontrar seu site
- Como corrigir a prévia do seu site ao compartilhar um link
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site