Errores de Registro
Las verificaciones que Arcton hace sobre las rutas y el middleware antes de que llegue cualquier request
Se verifica una sola vez, en el momento de registro
Construir el árbol de rutas ocurre una sola vez, cuando el módulo carga —
al llamar a .get()/.post()/etc., .use(), .ws(), o al propio
Arcton({ prefix }). Arcton valida cada una de estas llamadas de inmediato
y lanza una excepción de forma síncrona si algo está mal, así un error
falla rápido al arrancar en lugar de convertirse en un match confuso en
tiempo de request.
Ruta duplicada
Registrar el mismo método y path dos veces lanza:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/x', () => 'first')
app.get('/x', () => 'second')
app.listen()Duplicate route: GET /x is already registeredEsto también ocurre cuando montar un módulo produce un duplicado — ver Módulos.
Nombre de parámetro en conflicto
Dos nombres de parámetro distintos no pueden ocupar la misma posición en el árbol de rutas:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/users/:id', ctx => ctx.params.id)
app.get('/users/:userId', ctx => ctx.params.userId)
app.listen()Conflicting parameter name: "userId" conflicts with "id" at same positionUn segmento dinámico y uno wildcard en la misma posición no entran en conflicto entre sí — solo lo hacen dos segmentos dinámicos, o dos wildcard, con nombres distintos. Ver Precedencia.
Nombre de parámetro inválido
Un nombre :param o *wildcard debe empezar con una letra y contener solo
letras, dígitos o _:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/users/:1id', ctx => ctx.params)
app.listen()Invalid dynamic parameter name ":1id" in route "/users/:1id": must start with a letter and contain only letters, digits or "_"La misma verificación, con "wildcard" en lugar de "dynamic", aplica a los
segmentos *name.
Nombre de parámetro duplicado en una misma ruta
El mismo nombre de parámetro no puede aparecer dos veces en una sola ruta:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/pair/:a/:a', ctx => ctx.params.a)
app.listen()Duplicate parameter name "a" in route "/pair/:a/:a"Posición del segmento wildcard
Un segmento *wildcard debe ser el último segmento de la ruta:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/files/*path/edit', ctx => ctx.params.path)
app.listen()Wildcard segment must be the last segment in route "/files/*path/edit"Formato del path
Todo path de ruta debe empezar con / y no puede contener un segmento
vacío:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('users', () => 'nope')
app.listen()Route path must start with "/", got "users"import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/users//profile', () => 'nope')
app.listen()Route path must not contain empty segments ("//"): "/users//profile"Prefixes y scopes estáticos
ArctonConfig.prefix y el scope en use(scope, middleware) deben ser
ambos paths estáticos — sin segmentos :param ni *wildcard:
import { Arcton } from '@arcton/core'
const app = Arcton({ prefix: '/api/:version' })
app.listen()Prefix "/api/:version" must be a static path — dynamic/wildcard segments aren't supported (e.g. app.use('/api', mw), not app.use('/api/:id', mw))import { Arcton } from '@arcton/core'
const app = Arcton()
app.use('/users/:id', async (ctx, next) => {
await next()
})
app.listen()Scope "/users/:id" must be a static path — dynamic/wildcard segments aren't supported (e.g. app.use('/api', mw), not app.use('/api/:id', mw))use() con el argumento incorrecto
use() acepta una función de middleware, un par (scope, middleware), o
una app de Arcton para montar como módulo — cualquier otra cosa lanza una
excepción:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.use({} as never)
app.listen()use() expects a middleware function, a (scope, middleware) pair, or an Arcton app to mount