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 addData() 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 get() 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 addHeader() 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 post() 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 setBasicAuthentication() 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 setContent() is a function on the
HTTPClient
object to set the contents of the request body.
Function Signature
setContent(contents: string) : FiveError;
setContentType()
The setContentType() 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;