Skip to main content

HTTPClient

Last updated 1/10/2024

To create an instance of the

HTTPClient
object, you call the
httpClient()
function on the
Five
object to instantiate an instance of the
HTTPClient
object. This provides many ways to interact with existing web content using the Hypertext Transfer Protocol (HTTP), or the built-in headless web browser. HTTP is designed to enable communications between clients and servers working as a request-response protocol between a client and server for fetching resources such as HTML documents.

For example, a client (browser) sends a HTTP request to the server, the server then responds to the client with the response that contains status information about the request.

Five provides two modes to interact with an external API.

  • RAW - This is straight text or JSON from the server.
  • BROWSER - This is a full headless web browser session.

Functions

The following functions can used on the

HTTPClient
object.

addData()

The

is a function on the

HTTPClient
object that adds a key value pair to the body of the
POST
request, or as URL encoded URL parameters for a
GET
request when using RAW mode for the
get()
and
post()
methods and returns
null
on success.

Function Signature
addData(name: string, value: string) : FiveError;

get()

The

is a function on the

HTTPClient
object that is used to request data from a specific resource.

Function Signature
get([mode: string,] url: string) : HTTPResponse | BrowserPage;

addHeader()

The

is a function on the

HTTPClient
object that will let the client and the server pass additional information with a HTTP request or response.

Function Signature
addHeader(name: string, value: string) : FiveError;

post()

The

is a function on the

HTTPClient
object that is used to send data to the server to create/update a resource.

Function Signature
post([mode: string,] url: string) : HTTPResponse | BrowserPage;

setBasicAuthentication ()

The

is a function on the

HTTPClient
object that sets the basic authentication header for the request.

Function Signature
setBasicAuthentication(user: string, password: string) : FiveError;

setContent()

The

is a function on the

HTTPClient
object to set the contents of the request body.

Function Signature
setContent(contents: string) : FiveError;

setContentType()

The

is a function on the

HTTPClient
object that is used to indicate the original media type of the contents.

Function Signature
setContentType(mimeType: string) : FiveError;