Comprender cómo funcionan los objetos de request y response dentro de Cloudflare Workers es fundamental para construir aplicaciones robustas en el edge. Lo mejor es que Cloudflare respeta el estándar de JavaScript y TypeScript, lo que permite reutilizar todo el conocimiento de la industria directamente en tus workers.
¿Cómo configurar los MCPs de Cloudflare para acelerar el desarrollo?
Antes de entrar en los objetos request y response, vale la pena preparar el entorno. Configurar los MCPs de Cloudflare permite que el asistente de IA tenga acceso directo a la documentación oficial mientras escribes código [0:38]. Si utilizas CloudCode, puedes instalar los skills desde el Marketplace y conectarlos otorgando permisos de lectura.
El plugin más relevante en esta etapa es el de documentación, ya que el modelo sabrá exactamente dónde buscar cuando integres nuevas funcionalidades [1:30]. Esto reduce errores y acelera la generación de código cuando trabajas con tecnologías que se actualizan constantemente.
¿Qué es el objeto CF y por qué es clave en el request?
El objeto CF es una de las propiedades más importantes del request en Cloudflare Workers [2:13]. A través de él puedes obtener metadatos como:
- El país del visitante.
- La ciudad y la región.
- La zona horaria.
- Datos adicionales del tráfico.
Estos datos son la prueba de que realmente estás haciendo server side rendering, ya que desde el cliente no es posible acceder a esta información. En la documentación del Workers runtime [2:52] encontrarás la referencia completa con todos los parámetros disponibles: método, headers, body y ejemplos prácticos.
¿Cómo verificar las propiedades disponibles del objeto CF?
Con tecnologías que evolucionan rápidamente, algunas propiedades se agregan y otras se deprecan. Una técnica útil es revisar la observabilidad e inspeccionar los eventos de invocación directamente [3:42]. Ahí puedes ver todos los datos reales que el worker recibe, incluyendo información que también está disponible en los headers.
Esto permite validar formularios, recibir datos en el body, procesar parámetros de URL o manejar headers de autenticación con total certeza de qué propiedades están activas.
¿Cómo funciona el objeto response en Workers?
El objeto response también sigue el estándar de la industria [4:20]. Recibe un body y parámetros opcionales. Una diferencia importante es su propia versión del objeto CF, que se comporta de manera distinta al del request.
Cuando un worker actúa como proxy hacia otro servicio, esta propiedad permite configurar opciones de caché en la CDN [4:42]. Por ejemplo, si tu servidor de origen está en una ubicación remota y el worker está cerca del usuario, puedes agregar una cláusula de caché para que el contenido se sirva directamente desde la red de Cloudflare después de la primera solicitud.
¿Cómo integrar validaciones y documentación automática con Hono?
En la aplicación de backend, los headers del request se utilizan para extraer datos como el país del visitante [5:20]. Con Hono, el framework que se está usando, es posible acceder a query params, variables de URL, headers y parsear el body dependiendo del tipo de petición, ya sea JSON o archivos [5:55].
Para las validaciones, se utiliza una librería de Hono con OpenAPI [6:20]. Esto funciona como serializadores preconfigurados que validan el objeto JSON antes de que llegue a tu función principal. El consumo de cómputo ocurre un paso antes, protegiendo tu lógica de negocio.
¿Qué son los entornos de preview y cómo protegerlos?
Al conectar el repositorio con Cloudflare, cada nueva rama genera automáticamente un entorno de preview con su propia URL [7:10]. Cada commit tiene un hash único y también se genera una URL por nombre de rama, lo que permite acceder siempre a la última versión.
Esto crea un sistema de multi staging donde puedes probar cambios de forma aislada sin afectar producción [7:55]. También se agregó Swagger para tener autodocumentación del API.
Para proteger estos entornos, Cloudflare Access permite restringir el acceso de forma sencilla [8:20]. Si tu empresa requiere que los entornos de preview sean privados, esta herramienta es la solución directa.
¿Ya configuraste tus MCPs y entornos de preview? Comparte en los comentarios qué retos encontraste al activar Cloudflare Access en tu proyecto.
