Saltar al contenido principal

Introducción

🎯 ¿Qué hace este módulo?​

El módulo System te permite probar el manejo de páginas de error - simula errores 404 y 500 para verificar que tus páginas de error se muestren correctamente, ayudándote a asegurar un manejo adecuado de errores antes de que los usuarios encuentren problemas reales.

Piénsalo como tu herramienta de prueba de errores - activa errores de prueba bajo demanda, verifica que las páginas de error se rendericen correctamente y asegúrate de que tu lógica de manejo de errores funcione como se espera sin romper la producción.

📖 Explicación Simple​

Cada aplicación necesita un manejo adecuado de errores:

  • 🔍 404 No Encontrado - La página no existe
  • 💥 500 Error del Servidor - Fallo interno del servidor
  • 🎨 Páginas de Error Personalizadas - Experiencia de error de marca
  • 🔄 Registro de Errores - Rastrear ocurrencias de errores
  • 📊 Monitoreo de Errores - Detectar problemas temprano
  • ✅ Pruebas de Errores - Verificar que las páginas de error funcionen

Problemas:

  • 🔍 Sin validación - Las páginas de error pueden estar rotas
  • 🎨 Mala UX - Páginas de error predeterminadas feas
  • 🔄 Sin seguimiento - No se sabe cuándo ocurren los errores
  • 📊 Sin monitoreo - No se pueden detectar problemas

La solución de System:

Beneficios:

  • 🔍 Validado - Saber que las páginas de error funcionan
  • 🎨 Mejor UX - Páginas de error personalizadas de marca
  • 🔄 Rastreado - Registrar ocurrencias de errores
  • 📊 Monitoreado - Detectar problemas temprano

✨ Conceptos Clave​

¿Qué es el Módulo System?​

El módulo System proporciona utilidades de prueba:

  • Pruebas de Errores - Simular errores 404/500
  • Validación de Páginas de Error - Verificar que las páginas de error se rendericen
  • Verificación del Manejo de Errores - Probar la lógica de errores
  • Herramienta de Desarrollo - Usar durante el desarrollo/pruebas
  • No para Producción - No usar en código en vivo

Tipos de Errores​

Código de ErrorNombreCuándo OcurreCaso de Uso
404No EncontradoEl recurso solicitado no existePágina no encontrada, producto faltante
500Error Interno del ServidorOcurrió un error del lado del servidorFallo de base de datos, error de código

Flujo de Trabajo de Pruebas​

1. Desarrollar páginas de error
   (Páginas personalizadas 404 y 500)
   ↓
2. Implementar manejo de errores
   (Try/catch, límites de error)
   ↓
3. Probar con el módulo System
   (System.test404(), System.test500())
   ↓
4. Verificar que las páginas de error se muestren
   (Verificar UI, registro, seguimiento)
   ↓
5. Desplegar con confianza
   (Saber que el manejo de errores funciona)

¿Por qué usar el Módulo System?​

BeneficioDescripción
Validación de ErroresProbar páginas de error antes de que los usuarios las vean
Herramienta de DesarrolloActivar errores bajo demanda
Pruebas de Lógica de ErroresVerificar el código de manejo de errores
Páginas de Error PersonalizadasAsegurar una experiencia de error de marca
Detección TempranaCaptar problemas antes de la producción

📋 Lo Que Necesitas Saber​

El Módulo System es Solo para Pruebas​

Importante: Usa el módulo System solo durante el desarrollo y las pruebas.

¿Por qué?

  • Los errores de prueba no deben llegar a usuarios reales
  • Usar solo en entornos de desarrollo/etapa
  • Eliminar el código de prueba antes del despliegue en producción

Mejores Prácticas para Pruebas de Errores​

Prueba las páginas de error durante el desarrollo

Páginas de Error Personalizadas​

Crea páginas de error personalizadas para una mejor UX

Registro y Monitoreo de Errores​

Implementa el seguimiento de errores

💡 Notas Importantes​

Solo Herramienta de Desarrollo​

Recuerda: El módulo System es para pruebas, no para producción.

Pruebas de Errores vs Errores Reales​

Los errores del sistema son simulados:

  • Los errores de prueba no afectan a los usuarios reales
  • Usar para verificar la lógica de manejo de errores
  • Eliminar antes del despliegue en producción

Los errores reales ocurren naturalmente:

  • 404 real: Página no encontrada
  • 500 real: Fallo del servidor
  • Manejar con try/catch y límites de error

Páginas de Error Personalizadas Requeridas​

El módulo System solo activa errores - debes crear páginas de error

📊 Tabla de Referencia Rápida​

MétodoDescripciónLanzaCaso de Uso
test404()Simular error 404 No Encontrado404 ErrorProbar página de error 404
test500()Simular error 500 del Servidor500 ErrorProbar página de error 500

❓ Preguntas Comunes (FAQ)​

¿Cuándo debo usar el módulo System?​

Usa el módulo System solo durante el desarrollo y las pruebas para verificar que tus páginas de error funcionen correctamente. Nunca lo uses en código de producción - es puramente una herramienta de prueba para validar el manejo de errores.

¿Cómo pruebo mis páginas de error personalizadas?​

Llama a System.test404() o System.test500() en tu entorno de desarrollo. Estos métodos lanzan errores que activan tu lógica de manejo de errores, permitiéndote verificar que las páginas de error personalizadas se rendericen correctamente.

¿Cuál es la diferencia entre test404() y test500()?​

test404() simula un error "No Encontrado" (el recurso no existe), mientras que test500() simula un "Error Interno del Servidor" (fallo del lado del servidor). Prueba ambos para asegurarte de que todos los escenarios de error se manejen correctamente.

¿Puedo usar el módulo System en producción?​

¡No! El módulo System es estrictamente para desarrollo y pruebas. Elimina todas las llamadas de prueba del módulo System antes de desplegar en producción. Usa un manejo de errores real (try/catch, límites de error) para errores en producción.

¿Cómo creo páginas de error personalizadas?​

Crea componentes de página de error dedicados para errores 404 y 500 en tu aplicación. Usa límites de error (React) o un manejo de errores equivalente en tu marco para capturar errores y mostrar estas páginas personalizadas.

¿Debo registrar errores activados por el módulo System?​

Sí, registrar errores de prueba ayuda a verificar que tus sistemas de seguimiento y monitoreo de errores funcionen correctamente. Sin embargo, márcalos claramente como errores de prueba para evitar confusiones con problemas reales de producción.

🎓 Mejores Prácticas​

  • Prueba las páginas de error durante el desarrollo - Verifica que se rendericen correctamente
  • Usar solo en entorno de prueba - Nunca en producción
  • Implementa páginas de error personalizadas - Mejor UX que los errores predeterminados
  • Registra errores para depuración - Rastrear qué salió mal
  • Prueba límites de error - Manejo de errores en React/Vue
  • Verifica el seguimiento de errores - Asegúrate de que el monitoreo funcione
  • Elimina el código de prueba - Limpia antes del despliegue
  • Documenta el manejo de errores - Ayuda al equipo a entender el flujo

Más información sobre la interfaz de usuario del módulo https://doc.oneentry.cloud/docs/category/system

Definición del módulo System​

El módulo System en la Plataforma OneEntry proporciona métodos para probar redirecciones de páginas de error, permitiendo a los desarrolladores asegurarse de que sus mecanismos de manejo de errores estén funcionando correctamente. Al usar la función defineOneEntry, puedes crear un objeto System para acceder a estas funcionalidades. El módulo ofrece dos métodos principales: test404 y test500. Ambos métodos simulan escenarios en los que el usuario es redirigido a una página de error, específicamente páginas 404 (No Encontrado) y 500 (Error Interno del Servidor), respectivamente. Estas herramientas son esenciales para verificar que las páginas de error del sistema estén correctamente implementadas y se muestren a los usuarios cuando sea necesario.


const { System } = defineOneEntry(
  "tu-url-de-proyecto", {
    "token": "tu-token-de-aplicación"
  }
);

🔗 Documentación Relacionada​