Interface Request<T>

The request, passed as argument to endpoint functions.

interface Request<T extends JsonCompatible<T> = any> {
    body: Body<T>;
    caller?: AuthnIdentity;
    headers: { [key: string]: string };
    hostname: string;
    method: string;
    params: { [key: string]: string };
    path: string;
    query: string;
    route: string;
    url: string;
}

Type Parameters

Properties

body caller? headers hostname method params path query route url

Properties

body

body: Body<T>

An object to access the request body in various ways.

Optionalcaller

caller?: AuthnIdentity

An object describing the authenticated identity retrieved by the endpoint's authentication policies, or undefined if no policy is defined for the endpoint.

headers

headers: { [key: string]: string }

An object mapping lower-case HTTP header names to their values.

hostname

hostname: string

Hostname extracted from Host header, or null if header is missing

method

method: string

The HTTP method of the request.

For example GET /app/person/bob?fields=all becomes "GET"

params

params: { [key: string]: string }

An object mapping URL path parameter names to their values.

For example GET /app/person/bob?fields=all matched to /app/person/{name} becomes {"name": "bob"}

path

path: string

The path component of the requested URL.

For example GET /app/person/bob?fields=all becomes "/app/person/bob"

query

query: string

The query component of the requested URL.

For example GET /app/person/bob?fields=all becomes "fields=all"

route

route: string

The endpoint name which matched requested URL, potentially containing path parameters.

For example GET /app/person/bob?fields=all becomes "/app/person/{name}"

url

url: string

The full original requested URL.

For example GET /app/person/bob?fields=all becomes "/app/person/bob?fields=all"

Settings

Member Visibility

On This Page

Properties