Pular para o conteúdo principal

Introdução

🎯 O que este módulo faz?​

O módulo System permite que você teste o manuseio de páginas de erro - simule erros 404 e 500 para verificar se suas páginas de erro são exibidas corretamente, ajudando a garantir um manuseio adequado de erros antes que os usuários encontrem problemas reais.

Pense nisso como sua ferramenta de teste de erros - acione erros de teste sob demanda, verifique se as páginas de erro são renderizadas corretamente e assegure-se de que sua lógica de manuseio de erros funcione como esperado, sem quebrar a produção.

📖 Explicação Simples​

Toda aplicação precisa de um manuseio adequado de erros:

  • 🔍 404 Não Encontrado - A página não existe
  • 💥 500 Erro de Servidor - Falha interna do servidor
  • 🎨 Páginas de Erro Personalizadas - Experiência de erro com marca
  • 🔄 Registro de Erros - Rastrear ocorrências de erros
  • 📊 Monitoramento de Erros - Detectar problemas precocemente
  • ✅ Teste de Erros - Verificar se as páginas de erro funcionam

Problemas:

  • 🔍 Sem validação - Páginas de erro podem estar quebradas
  • 🎨 UX Ruim - Páginas de erro padrão feias
  • 🔄 Sem rastreamento - Não sabe quando os erros ocorrem
  • 📊 Sem monitoramento - Não consegue detectar problemas

A solução do System:

Benefícios:

  • 🔍 Validado - Saber que as páginas de erro funcionam
  • 🎨 Melhor UX - Páginas de erro personalizadas
  • 🔄 Rastreado - Registrar ocorrências de erros
  • 📊 Monitorado - Detectar problemas precocemente

✨ Conceitos Chave​

O que é o Módulo System?​

O módulo System fornece utilitários de teste:

  • Teste de Erros - Simular erros 404/500
  • Validação de Páginas de Erro - Verificar se as páginas de erro são renderizadas
  • Verificação de Manuseio de Erros - Testar a lógica de erro
  • Ferramenta de Desenvolvimento - Usar durante o desenvolvimento/teste
  • Não para Produção - Não usar em código ao vivo

Tipos de Erros​

Código de ErroNomeQuando OcorreCaso de Uso
404Não EncontradoO recurso solicitado não existePágina não encontrada, produto ausente
500Erro Interno do ServidorOcorreu um erro do lado do servidorFalha no banco de dados, erro de código

Fluxo de Trabalho de Teste​

1. Desenvolver páginas de erro
   (Páginas personalizadas 404 e 500)
   ↓
2. Implementar manuseio de erros
   (Try/catch, limites de erro)
   ↓
3. Testar com o módulo System
   (System.test404(), System.test500())
   ↓
4. Verificar exibição das páginas de erro
   (Verificar UI, registro, rastreamento)
   ↓
5. Implantar com confiança
   (Saber que o manuseio de erros funciona)

Por que usar o Módulo System?​

BenefícioDescrição
Validação de ErrosTestar páginas de erro antes que os usuários as vejam
Ferramenta de DesenvolvimentoAcionar erros sob demanda
Teste de Lógica de ErrosVerificar o código de manuseio de erros
Páginas de Erro PersonalizadasGarantir uma experiência de erro com marca
Detecção PrecoceCapturar problemas antes da produção

📋 O que você precisa saber​

O Módulo System é apenas para Testes​

Importante: Use o módulo System apenas durante desenvolvimento e teste.

Por quê?

  • Erros de teste não devem alcançar usuários reais
  • Usar apenas em ambientes de desenvolvimento/estágio
  • Remover código de teste antes da implantação em produção

Melhores Práticas para Teste de Erros​

Teste páginas de erro durante o desenvolvimento

Páginas de Erro Personalizadas​

Crie páginas de erro personalizadas para uma melhor UX

Registro e Monitoramento de Erros​

Implemente rastreamento de erros

💡 Notas Importantes​

Apenas Ferramenta de Desenvolvimento​

Lembre-se: O módulo System é para teste, não produção.

Teste de Erros vs Erros Reais​

Erros do System são simulados:

  • Erros de teste não afetam usuários reais
  • Usar para verificar a lógica de manuseio de erros
  • Remover antes da implantação em produção

Erros reais ocorrem naturalmente:

  • 404 real: Página não encontrada
  • 500 real: Falha no servidor
  • Manusear com try/catch e limites de erro

Páginas de Erro Personalizadas Necessárias​

O módulo System apenas aciona erros - você deve criar páginas de erro

📊 Tabela de Referência Rápida​

MétodoDescriçãoLançaCaso de Uso
test404()Simular erro 404 Não EncontradoErro 404Testar página de erro 404
test500()Simular Erro 500 de ServidorErro 500Testar página de erro 500

❓ Perguntas Comuns (FAQ)​

Quando devo usar o módulo System?​

Use o módulo System apenas durante o desenvolvimento e teste para verificar se suas páginas de erro funcionam corretamente. Nunca use em código de produção - é puramente uma ferramenta de teste para validar o manuseio de erros.

Como faço para testar minhas páginas de erro personalizadas?​

Chame System.test404() ou System.test500() em seu ambiente de desenvolvimento. Esses métodos lançam erros que acionam sua lógica de manuseio de erros, permitindo que você verifique se as páginas de erro personalizadas são renderizadas corretamente.

Qual é a diferença entre test404() e test500()?​

test404() simula um erro "Não Encontrado" (o recurso não existe), enquanto test500() simula um "Erro Interno do Servidor" (falha do lado do servidor). Teste ambos para garantir que todos os cenários de erro sejam tratados corretamente.

Posso usar o módulo System em produção?​

Não! O módulo System é estritamente para desenvolvimento e teste. Remova todas as chamadas de teste do módulo System antes de implantar em produção. Use o manuseio real de erros (try/catch, limites de erro) para erros de produção.

Como faço para criar páginas de erro personalizadas?​

Crie componentes de página de erro dedicados para erros 404 e 500 em sua aplicação. Use limites de erro (React) ou manuseio de erro equivalente em seu framework para capturar erros e exibir essas páginas personalizadas.

Devo registrar erros acionados pelo módulo System?​

Sim, registrar erros de teste ajuda a verificar se seus sistemas de rastreamento e monitoramento de erros funcionam corretamente. No entanto, marque-os claramente como erros de teste para evitar confusão com problemas reais de produção.

🎓 Melhores Práticas​

  • Teste páginas de erro durante o desenvolvimento - Verifique se elas são renderizadas corretamente
  • Use apenas em ambiente de teste - Nunca em produção
  • Implemente páginas de erro personalizadas - Melhor UX do que erros padrão
  • Registre erros para depuração - Rastreie o que deu errado
  • Teste limites de erro - Manuseio de erros em React/Vue
  • Verifique o rastreamento de erros - Assegure-se de que o monitoramento funcione
  • Remova código de teste - Limpe antes da implantação
  • Documente o manuseio de erros - Ajude a equipe a entender o fluxo

Mais informações sobre a interface do usuário do módulo https://doc.oneentry.cloud/docs/category/system

Definição do módulo System​

O módulo System na Plataforma OneEntry fornece métodos para testar redirecionamentos de páginas de erro, permitindo que os desenvolvedores garantam que seus mecanismos de manuseio de erros estejam funcionando corretamente. Ao usar a função defineOneEntry, você pode criar um objeto System para acessar essas funcionalidades. O módulo oferece dois métodos principais: test404 e test500. Ambos os métodos simulam cenários em que o usuário é redirecionado para uma página de erro, especificamente páginas 404 (Não Encontrado) e 500 (Erro Interno do Servidor), respectivamente. Essas ferramentas são essenciais para verificar se as páginas de erro do sistema estão implementadas e exibidas corretamente para os usuários quando necessário.


const { System } = defineOneEntry(
  "sua-url-do-projeto", {
    "token": "seu-token-de-aplicativo"
  }
);

🔗 Documentação Relacionada​