ArctonArcton
Validación

Parsers de Body

Cómo Arcton parsea el body de una request según el Content-Type antes de validarlo, y cómo agregar tu propio parser.

El parseo de body solo pasa para una ruta que declaró un esquema de body — ver Body. Arcton elige un parser según el Content-Type de la request (los parámetros como ; charset= se ignoran, y la comparación no distingue mayúsculas de minúsculas), lo ejecuta, y le entrega el resultado a tu esquema. Una ruta acepta únicamente application/json por defecto; cualquier otro media type hay que listarlo con content — ver Aceptar media types específicos.

Parsers integrados

Estos son los parsers que trae Arcton. Una ruta solo recibe un media type que acepta: application/json por defecto, o los que lista en content.

Content-TypeValor parseado
application/json y cualquier application/*+jsonawait request.json()
text/plainstring
application/x-www-form-urlencodedFormData
multipart/form-dataFormData
application/octet-streamArrayBuffer

Una request cuyo Content-Type la ruta no acepta — o que no tiene parser, integrado o personalizado — recibe 415 con un body vacío. Un parser integrado que lanza un error con un input malformado (JSON inválido, por ejemplo) responde 400 con {"issues":[{"message":"Invalid request body"}]}. Una request sin body nunca llega a un parser cuando el body de la ruta es opcional.

Registrando tu propio parser

app.parser(mediaType, parser) registra un parser para un media type exacto, sobrescribiendo uno integrado para el mismo tipo si existe. Registrar el mismo media type de nuevo reemplaza el parser anterior — es una tabla plana, no un pipeline ordenado, así que no importa en qué momento lo llames respecto a tus rutas.

import { Arcton } from '@arcton/core'
import * as v from 'valibot'

const app = Arcton()

app.parser('text/csv', async request => {
  const [header = '', ...rows] = (await request.text()).trim().split('\n')
  const keys = header.split(',')
  return rows.map(row =>
    Object.fromEntries(keys.map((key, i) => [key, row.split(',')[i]]))
  )
})

app.post('/import', {
  body: {
    content: { 'text/csv': v.array(v.record(v.string(), v.string())) }
  },
  handler: ctx => ({ imported: ctx.body.length, rows: ctx.body })
})

app.listen()

Un BodyParser recibe el Request crudo, no ctx — el parseo no tiene nada que ver con el context de la ruta.

Devolver undefined desde un parser personalizado significa "no manejo esta request" y cae en 415, igual que si no hubiera ningún parser registrado. Cualquier otro valor cuenta como manejado, incluyendo false, 0 y ''. Un parser personalizado que lanza un error se propaga sin capturar, igual que si lo lanzara un handler o provide() — no se atrapa en un 400 como sí pasa con el error de un parser integrado.

En esta página