Errores no Capturados
Qué pasa cuando un handler, provider o parser lanza una excepción
Un throw se convierte en un 500
El propio pipeline de Arcton — providers, middleware, validación, el
handler — nunca se traga una excepción. Si un handler, un
provider, o un body parser personalizado
registrado con app.parser() lanza una excepción, ese error se propaga
hasta llegar al runtime adapter que sirve la request — a menos que la app
haya registrado un manejador global de errores,
que lo captura antes.
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/risky', () => {
throw new Error('boom')
})
app.listen()Una request a /risky aquí registra el error con console.error y
responde con un 500 — los dos adapters que vienen con el framework se
comportan así. Ver Adapters para el mecanismo exacto
en Bun y Node.
Dos errores que el propio Arcton puede lanzar en tiempo de request
Un par de checks propios de Arcton lanzan una excepción de forma síncrona mientras se construye una respuesta, y quedan sin capturar de la misma manera:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/broken', ctx => {
ctx.response.status = 999
return { ok: true }
})
app.listen()Configurar un status fuera de [200, 599] lanza
Invalid response status 999: must be between 200 and 599 cuando la
respuesta se materializa — el mismo resultado en 500 que cualquier otro
throw no capturado. Asignar ctx.response.status después de que el body ya
finalizó lanza por una razón distinta
(TypeError: Attempted to assign to readonly property.) — ver el callout
en Respondiendo con errores.
Conviene envolver las partes de la aplicación que pueden fallar legítimamente — una llamada downstream, un parseo del que no se confía — con los patrones de Respondiendo con errores, o capturar todo en un solo lugar con un manejador global de errores, en lugar de dejar que lleguen al adapter como un 500 sin más.