cowboy_req:headers(3)

Name

cowboy_req:headers - HTTP headers

Description

headers(Req :: cowboy_req:req()) -> cowboy:http_headers()

Return all request headers.

Request headers can also be obtained using pattern matching:

#{headers := Headers} = Req.

Arguments

Req

The Req object.

Return value

Headers are returned as a map with keys being lowercase binary strings, and values as binary strings.

Changelog

  • 2.0: Only the headers are returned, they are no longer wrapped in a tuple.
  • 1.0: Function introduced.

Examples

Get all headers
Headers = cowboy_req:headers(Req).

See also

cowboy_req(3), cowboy_req:header(3), cowboy_req:parse_header(3)

Cowboy 2.12 Function Reference

Navigation

Version select

Like my work? Donate!

Donate to Loïc Hoguin because his work on Cowboy, Ranch, Gun and Erlang.mk 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.