kotlin-actions-http-client/actions.http.client/HttpClient

HttpClient

Constructors

constructor(userAgent: String = definedExternally, handlers: ReadonlyArray<RequestHandler> = definedExternally, requestOptions: RequestOptions = definedExternally)

Properties

handlers

external var handlers: ReadonlyArray<RequestHandler>

requestOptions

external var requestOptions: RequestOptions?

userAgent

external var userAgent: String?

Functions

del

external fun del(requestUrl: String, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

dispose

external fun dispose()

Needs to be called if keepAlive is set to true in request options.

get

external fun get(requestUrl: String, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

getAgent

external fun getAgent(serverUrl: String): Agent

Gets an http agent. This function is useful when you need an http agent that handles routing through a proxy server - depending upon the url and proxy environment variables.

getAgentDispatcher

external fun getAgentDispatcher(serverUrl: String): Any?

getJson

external fun <T> getJson(requestUrl: String, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<TypedResponse<T>>

Gets a typed object from an endpoint Be aware that not found returns a null. Other errors (4xx, 5xx) reject the promise

head

external fun head(requestUrl: String, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

options

external fun options(requestUrl: String, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

patch

external fun patch(requestUrl: String, data: String, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

patchJson

external fun <T> patchJson(requestUrl: String, obj: Any?, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<TypedResponse<T>>

post

external fun post(requestUrl: String, data: String, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

postJson

external fun <T> postJson(requestUrl: String, obj: Any?, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<TypedResponse<T>>

put

external fun put(requestUrl: String, data: String, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

putJson

external fun <T> putJson(requestUrl: String, obj: Any?, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<TypedResponse<T>>

request

external fun request(verb: String, requestUrl: String, data: String?, headers: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

Makes a raw http request. All other methods such as get, post, patch, and request ultimately call this. Prefer get, del, post and patch

external fun request(verb: String, requestUrl: String, data: ReadableStream?, headers: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>

requestRaw

external fun requestRaw(info: RequestInfo, data: String?): Promise<HttpClientResponse>

Raw request.

external fun requestRaw(info: RequestInfo, data: ReadableStream?): Promise<HttpClientResponse>

requestRawWithCallback

external fun requestRawWithCallback(info: RequestInfo, data: String?, onResult: (JsError?, res: HttpClientResponse?) -> Unit)

Raw request with callback.

external fun requestRawWithCallback(info: RequestInfo, data: ReadableStream?, onResult: (JsError?, res: HttpClientResponse?) -> Unit)

sendStream

external fun sendStream(verb: String, requestUrl: String, stream: ReadableStream, additionalHeaders: OutgoingHttpHeaders = definedExternally): Promise<HttpClientResponse>