ArctonArcton
Fundamentos

Ciclo de vida de la request

Cómo una request viaja desde el router, pasando por la validación, hasta tu handler y de vuelta a una response.

Toda request que atiende una app de Arcton pasa por la misma secuencia de etapas:

coincidencia → pasos globales (snapshot al registrar) → validar → route middleware → handler → mapeo de response

Esta página recorre cada etapa a nivel conceptual y enlaza a dónde se cubre en profundidad.

Coincidencia

El método y el pathname entrantes se comparan contra el árbol de rutas. Una coincidencia trae la cadena de handlers construida para esa ruta, más los params capturados en el camino. Si no hay coincidencia, cae en un 404; si coincide la ruta pero no el método, cae en un 405 — ver Descripción general de routing, Precedencia y Errores.

El snapshot de pasos globales

Esto es lo más importante que hay que saber sobre cómo se componen middleware y providers: cuando se registra una ruta, esta captura las llamadas a use() y provide() hechas hasta ese momento. Las llamadas hechas después del registro no la alcanzan.

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/before', () => 'registered with no global steps yet')

app.use(async (ctx, next) => {
  ctx.response.headers.set('X-Global', 'yes')
  await next()
})

app.get('/after', () => 'registered after the middleware above')

app.listen()

/before corre sin ninguna de las llamadas use()/provide() de alrededor, porque ninguna existía todavía cuando se registró. /after corre envuelta por el middleware de arriba, porque ese middleware ya estaba registrado. Reordenar las dos llamadas a get() respecto a use() cambia lo que corre cada ruta — el router nunca vuelve a revisar esto después. Ver Orden de ejecución para las reglas completas de orden, incluyendo middleware con scope y modules montados.

Validar

Si la ruta declaró esquemas de params, query o body, corren en ese orden contra los valores actuales, reemplazando ctx.params / ctx.query / ctx.body con el resultado validado (y posiblemente transformado). El primer esquema que falla detiene la request ahí mismo. Ver Descripción general de validación.

Route middleware

El middleware que se pasa directamente a una ruta corre al final, lo más cerca posible del handler — después de cada step global y con scope, después de la validación. Ver Middleware a nivel de ruta.

Handler

El handler corre con un ctx completamente tipado — ver Context para lo que hay en él a esta altura.

Mapeo de response

Lo que sea que devuelva el handler (o un step anterior que cortó la cadena) se mapea a un Response HTTP, combinado con lo que ya esté definido en ctx.response. Ver Response para el mapeo completo.

En esta página