kotlin-electron/electron.core/ClientRequest

ClientRequest

external class ClientRequest : EventEmitter(source)

Constructors

ClientRequest

constructor(options: ClientRequestConstructorOptions)

ClientRequest

constructor(options: String)

ClientRequest

Properties

abortEvent

val abortEvent: EventInstance<JsTuple>

chunkedEncoding

var chunkedEncoding: Boolean

A boolean specifying whether the request will use HTTP chunked transfer encoding or not. Defaults to false. The property is readable and writable, however it can be set only before the first write operation as the HTTP headers are not yet put on the wire. Trying to set the chunkedEncoding property after the first write will throw an error.

closeEvent

val closeEvent: EventInstance<JsTuple>

errorEvent

val errorEvent: EventInstance<JsTuple1<JsError>>

finishEvent

val finishEvent: EventInstance<JsTuple>

loginEvent

val loginEvent: EventInstance<JsTuple2<AuthInfo, (username: String?, password: String?) -> Unit>>

redirectEvent

val redirectEvent: EventInstance<JsTuple4<Double, String, String, ReadonlyRecord<String, ReadonlyArray<String>>>>

responseEvent

val responseEvent: EventInstance<JsTuple1<IncomingMessage>>

Functions

abort

fun abort()

Cancels an ongoing HTTP transaction. If the request has already emitted the close event, the abort operation will have no effect. Otherwise an ongoing event will emit abort and close events. Additionally, if there is an ongoing response object,it will emit the aborted event.

addListener

fun addListener(type: EventType, listener: EventListener)

emit

fun emit(type: EventType, vararg args: Any?): Boolean

end

fun end()

fun end(chunk: String = definedExternally, encoding: String = definedExternally, callback: () -> Unit = definedExternally)

fun end(chunk: Buffer = definedExternally, encoding: String = definedExternally, callback: () -> Unit = definedExternally)

Sends the last chunk of the request data. Subsequent write or end operations will not be allowed. The finish event is emitted just after the end operation.

eventNames

fun eventNames(): Array<EventType>

followRedirect

fun followRedirect()

Continues any pending redirection. Can only be called during a 'redirect' event.

getHeader

fun getHeader(name: String): String

The value of a previously set extra header name.

getMaxListeners

fun getMaxListeners(): Double

getUploadProgress

fun getUploadProgress(): UploadProgress

You can use this method in conjunction with POST requests to get the progress of a file upload or other data transfer.

listenerCount

fun listenerCount(type: EventType, listener: EventListener): Double

listeners

fun listeners(type: EventType): Array<EventListener>

off

fun off(type: EventType, listener: EventListener)

fun on(type: EventType, listener: EventListener)

once

fun once(type: EventType, listener: EventListener)

prependListener

fun prependListener(type: EventType, listener: EventListener)

prependOnceListener

fun prependOnceListener(type: EventType, listener: EventListener)

rawListeners

fun rawListeners(type: EventType): Array<EventListener>

removeAllListeners

fun removeAllListeners(type: EventType)

removeHeader

fun removeHeader(name: String)

Removes a previously set extra header name. This method can be called only before first write. Trying to call it after the first write will throw an error.

removeListener

fun removeListener(type: EventType, listener: EventListener)

setHeader

fun setHeader(name: String, value: String)

Adds an extra HTTP header. The header name will be issued as-is without lowercasing. It can be called only before first write. Calling this method after the first write will throw an error. If the passed value is not a string, its toString() method will be called to obtain the final value.

setMaxListeners

fun setMaxListeners(n: Number)

write

fun write(chunk: String, encoding: String = definedExternally, callback: () -> Unit = definedExternally)

fun write(chunk: Buffer, encoding: String = definedExternally, callback: () -> Unit = definedExternally)

callback is essentially a dummy function introduced in the purpose of keeping similarity with the Node.js API. It is called asynchronously in the next tick after chunk content have been delivered to the Chromium networking layer. Contrary to the Node.js implementation, it is not guaranteed that chunk content have been flushed on the wire before callback is called.