ArctonArcton
Enrutamiento

HTTP Methods

Los siete métodos abreviados, registrar varios métodos en un mismo path, y cómo responde Arcton a un método para el que no tiene handler.

Cada método HTTP tiene su propio método de registro:

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/users/:id', ctx => ({ id: ctx.params.id }))
app.post('/users', () => ({ created: true }))
app.put('/users/:id', ctx => ({ replaced: ctx.params.id }))
app.patch('/users/:id', ctx => ({ updated: ctx.params.id }))
app.delete('/users/:id', ctx => ({ deleted: ctx.params.id }))
app.head('/users/:id', () => {})
app.options('/users', () => {})

app.listen()

Los siete disponibles son get, post, put, delete, patch, head y options. Se comportan idénticos más allá del método que responden, y todos aceptan las mismas dos formas de llamada — un handler con middleware de ruta opcional, o un objeto de opciones con schemas.

Varios métodos en un mismo path

Regístralos uno por uno. Como cada llamada retorna la app, un recurso se lee como un bloque:

import { Arcton } from '@arcton/core'

const app = Arcton()

app
  .get('/users/:id', ctx => ({ id: ctx.params.id }))
  .put('/users/:id', ctx => ({ replaced: ctx.params.id }))
  .delete('/users/:id', ctx => ({ deleted: ctx.params.id }))

app.listen()

Registrar el mismo método y path dos veces tira un error al registrarse — ver Registration errors.

Todos los métodos en un mismo path

app.all() registra el mismo handler para los siete métodos anteriores en una sola llamada. Sirve sobre todo para delegar un path completo — muchas veces un subárbol wildcard — a un handler externo de Request/Response, por ejemplo montar una librería como better-auth:

import { Arcton } from '@arcton/core'

declare const auth: { handler: (request: Request) => Promise<Response> }

const app = Arcton()

app.all('/api/auth/*path', ctx => auth.handler(ctx.request))

app.listen()

all no es un comodín para verbos HTTP arbitrarios o no estándar — expande exactamente a los mismos siete métodos que responden get/post/etc. Un request con otro verbo sigue recibiendo 405 (si el path matchea otra cosa) o 404.

Como comparte el mismo handler entre los siete métodos, registrar all() y luego un método específico en el mismo path — en cualquier orden — tira el mismo error de "Duplicate route" que registrar ese método dos veces; ver Registration errors. Y como cualquier segmento wildcard, /api/auth/*path necesita al menos un segmento para matchear — si necesitas que /api/auth a secas también responda, hace falta registrarlo aparte.

Method not allowed

Cuando el path de un request matchea pero su método no tiene handler, Arcton responde 405 con un header Allow listando los métodos que ese path sí responde:

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/users/:id', ctx => ({ id: ctx.params.id }))
app.post('/users/:id', ctx => ({ updated: ctx.params.id }))

app.listen()

DELETE /users/42 retorna 405 con Allow: GET, POST y el cuerpo vacío.

El path que responde es el más específico que matcheó, y el matching no sigue buscando más allá de él otro patrón que soporte el método — Precedence desarrolla las consecuencias de esto.

HEAD y OPTIONS

Acá ambos son métodos ordinarios: responden cuando los registras.

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/users/:id', ctx => ({ id: ctx.params.id }))

app.head('/users/:id', ctx => {
  ctx.response.headers.set('Content-Type', 'application/json')
})

app.options('/users/:id', ctx => {
  ctx.response.status = 204
  ctx.response.headers.set('Allow', 'GET, HEAD, OPTIONS')
})

app.listen()

Para requests de preflight cross-origin, @arcton/cors maneja el intercambio de OPTIONS por ti, y solo intercepta requests que llevan Access-Control-Request-Method — así que una ruta app.options() que registres para tus propios fines sigue funcionando junto a él.

Elegir un status code

Un handler responde 200 a menos que digas lo contrario. Asigna ctx.response.status antes de retornar:

import { Arcton } from '@arcton/core'

const app = Arcton()

app.post('/users', ctx => {
  ctx.response.status = 201
  ctx.response.headers.set('Location', '/users/42')

  return { id: '42' }
})

app.delete('/users/:id', ctx => {
  ctx.response.status = 204
})

app.listen()

204, 205 y 304 siempre envían el cuerpo vacío, sea lo que sea que retorne el handler. Ver Response.

En esta página