URLParamsParser

URLParamsParser is the default ObjectParserInterface<Record<string, string>> implementation in the registry and extends ObjectParserAbstract. It converts the raw URL parameters matched by the router (:id, :slug, ...) into a plain object with decoded and coerced values. Its output is c.params in route handlers.

Usage

You normally don't call it directly. For a route GET /users/:id/posts/:slug and a request to /users/5/posts/hello%20world, c.params becomes:

{
	id: 5,
	slug: "hello world",
}

Replace it with your own implementation through the Registry.

Behavior

Parameters are flat: keys come from the route definition, so there is no bracket/dot nesting. Each value is decodeURIComponent-ed and then coerced with tryParseJSON:

Note the coercion consequence: /users/5 gives c.params.id as a number while /users/abc gives a string. If a param must always be one type, validate it with the params schema in the route model.