Params y Query
Valida los params de ruta y los query strings con un esquema y lee el resultado transformado desde `ctx`.
Sin un esquema, ctx.params viene del literal de ruta y ctx.query es
Record<string, string> — ver Context,
Parámetros de ruta y
Parámetros de query. Declarar un esquema de
params o query reemplaza el que sea con el output propio del esquema, coerciones
incluidas.
Params
Los params de ruta siempre llegan como strings — un esquema de params es la forma
de convertir :id en algo más útil:
import { Arcton } from '@arcton/core'
import * as v from 'valibot'
const app = Arcton()
app.get('/users/:id', {
params: v.object({
id: v.pipe(v.string(), v.transform(Number), v.number())
}),
handler: ctx => ({ id: ctx.params.id, doubled: ctx.params.id * 2 })
})
app.listen()ctx.params.id está tipado y valuado como number, así que las operaciones
aritméticas sobre él simplemente funcionan.
Query
Los valores de query también son strings, y a menudo opcionales — un esquema de
query es donde conviertes ?limit=10 en un number real con un default real:
import { Arcton } from '@arcton/core'
import * as v from 'valibot'
const app = Arcton()
app.get('/search', {
query: v.object({
q: v.pipe(v.string(), v.minLength(1)),
limit: v.optional(
v.pipe(v.string(), v.transform(Number), v.number())
)
}),
handler: ctx => ({ query: ctx.query.q, limit: ctx.query.limit ?? 10 })
})
app.listen()limit se mantiene como number | undefined porque es opcional — el fallback con
?? pasa en el handler.
Orden
Cuando una ruta declara ambos, params se valida antes que query, y cualquiera de
los dos puede cortar la cadena con 400 antes de que corra el otro — ver
Descripción general de validación y
Errores de validación.