HTTP Response reference

The response object holds the information about a received HTTP Response (response content, headers, status, and so on) and provides access to the headers and contentType nested objects.

Response properties

Property	Description
`body` (string \| LineStreamResponse \| object)	Response content, which can be a string, a LineStreamResponse object, or a JSON object.
`headers` (ResponseHeaders)	The response headers storage object.
`status` (int)	Response status, for example, 200 or 404.
`contentType` (ContentType)	The contentType object, which holds the data on the Content-Type response header value.

Headers object

The ResponseHeaders object is used for retrieving the data about response headers' values.

Methods

Method	Parameters	Description
valueOf	`headerName` (string)	Retrieves the first value of the `headerName` response header or `null` if the `headerName` response header does not exist.
valuesOf	`headerName` (string)	Retrieves the array containing all values of the `headerName` response header. Returns an empty array if the `headerName` response header does not exist.

ContentType object

The ContentType data object contains information from the Content-Type response header.

Properties

Property	Description
`mimeType` (string)	The MIME type of the response, for example, text/plain, text/xml, application/json.
`charset` (string)	The string representation of the response charset, for example, utf-8.

LineStreamResponse object

The LineStreamResponse interface is used to process a response as a stream of lines. It implements a onEachLine(line, unsubscribe) method, which loops through each line in the stream, one after the other. The method takes two arguments:

Arguments

Argument	Description
`line` (a string or a JSON object)	A line (event) received as part of the stream.
`unsubscribe`	Function to terminate execution of the `onEachLine` block.

Request properties

The request object holds the information about the HTTP request.

Property	Description
`body` (string)	The request body as a string.
`environment`	Accepts the `get(name)`, which retrieves a value of the environment variable identified by its `name` or returns `null` if it does not exist.
`headers`	Has two methods: `all`: retrieves the array containing the values of all headers. `findByName(name)`: retrieves the value of the header identified by the `name` parameter.
`url` (string)	The request URL.
`variables`	Accepts the `get(name)` method, which retrieves a value of the per-request variable identified by its `name` or returns `null` if it does not exist.

Last modified: 12 December 2022