HttpOptions
Allows configuration of additional options for when sending an HTTP request.
Summary
Constructors
| HttpOptions(headers: table = {}, timeout: int = 30) |
Properties
| Name | Type |
|---|---|
| timeout | int |
| verifyCertificate | bool |
| headers | table |
Methods
| Method | Returns |
|---|---|
| SetHeader(header: string, value: string) | void |
| RemoveHeader(header: string) | void |
| GetHeader(header: string) | string |
| HasHeader(header: string) | bool |
Constructors
HttpOptions
HttpOptions(headers: table = {}, timeout: int = 30)
Parameters
| Name | Type | Description |
|---|---|---|
| headers | table | An associative table containing the request headers. |
| timeout | int | The connection timeout in seconds. |
Properties
timeout
int
The connection timeout in seconds.
verifyCertificate
bool
Whether to verify the remote SSL certificate. Defaults to true. Changing it to false is not recommended.
headers
table
An associative table containing the request headers.
Methods
SetHeader
SetHeader(header: string, value: string)
Sets the value of the header with the specified name. The User-Agent header cannot be set.
Parameters
| Name | Type | Description |
|---|---|---|
| header | string | The case-insensitive header name (eg. Content-Type). |
| value | string | The header value (eg. application/json). |
RemoveHeader
RemoveHeader(header: string)
Removes the header with the specified name. The User-Agent header cannot be removed.
Parameters
| Name | Type | Description |
|---|---|---|
| header | string | The case-insensitive header name (eg. Content-Type). |
GetHeader
GetHeader(header: string): string
Returns the value of a header with the specified name. If the header is not found it returns an empty string.
Parameters
| Name | Type | Description |
|---|---|---|
| header | string | The case-insensitive header name (eg. Content-Type). |
Returns
| Type | Description |
|---|---|
| string |
HasHeader
HasHeader(header: string): bool
Checks if a header with the specified name exists.
Parameters
| Name | Type | Description |
|---|---|---|
| header | string | The case-insensitive header name (eg. Content-Type). |
Returns
| Type | Description |
|---|---|
| bool |