cowboy_constraints - Constraints


The module cowboy_constraints defines the built-in constraints in Cowboy and provides an interface for manipulating these constraints.

Constraints are functions that define what type of input is allowed. They are used throughout Cowboy, from the router to query strings to cookies.


Built-in constraints:



constraint() :: int | nonempty | fun()

A constraint function.

The atom constraints are built-in, see the corresponding function in the exports list above.


reason() :: {constraint(), Reason, Value}

Reason :: any()
Value  :: any()

Reason for the constraint failure.

It includes the constraint function in question, a machine-readable error reason and the value that made the constraint fail.

See also

cowboy(7), cowboy(3), cowboy_router(3), cowboy_req:match_cookies(3), cowboy_req:match_qs(3)

Cowboy 2.7 Function Reference


Version select

Like my work? Donate!

Donate to Loïc Hoguin because his work on Cowboy, Ranch, Gun and is fantastic:

Recurring payment options are also available via GitHub Sponsors. These funds are used to cover the recurring expenses like food, dedicated servers or domain names.