WebSocket

open class WebSocket(val url: String, val protocol: String = definedExternally) : EventTarget(source)

The WebSocket object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.

MDN Reference

Constructors

WebSocket

constructor(url: URL, protocol: String = definedExternally)

constructor(url: String, protocols: ReadonlyArray<JsString>)

constructor(url: URL, protocols: ReadonlyArray<JsString>)

constructor(url: String, protocol: String = definedExternally)

Types

Companion

object Companion

ReadyState

sealed interface ReadyState

Properties

binaryType

var binaryType: BinaryType

The WebSocket.binaryType property controls the type of binary data being received over the WebSocket connection.

bufferedAmount

val bufferedAmount: UInt53

The WebSocket.bufferedAmount read-only property returns the number of bytes of data that have been queued using calls to send() but not yet transmitted to the network.

CLOSED

val CLOSED: WebSocket.ReadyState

closeEvent

val closeEvent: EventInstance<CloseEvent, WebSocket, WebSocket>

MDN Reference

CLOSING

val CLOSING: WebSocket.ReadyState

CONNECTING

val CONNECTING: WebSocket.ReadyState

errorEvent

val errorEvent: EventInstance<Event, WebSocket, WebSocket>

MDN Reference

extensions

val extensions: String

The WebSocket.extensions read-only property returns the extensions selected by the server.

messageEvent

val messageEvent: EventInstance<MessageEvent<JsAny?>, WebSocket, WebSocket>

MDN Reference

onclose

var onclose: EventHandler<CloseEvent, WebSocket, WebSocket>?

MDN Reference

onerror

var onerror: EventHandler<Event, WebSocket, WebSocket>?

MDN Reference

onmessage

var onmessage: EventHandler<MessageEvent<*>, WebSocket, WebSocket>?

MDN Reference

onopen

var onopen: EventHandler<Event, WebSocket, WebSocket>?

MDN Reference

OPEN

val OPEN: WebSocket.ReadyState

openEvent

val openEvent: EventInstance<Event, WebSocket, WebSocket>

MDN Reference

protocol

val protocol: String

The WebSocket.protocol read-only property returns the name of the sub-protocol the server selected; this will be one of the strings specified in the protocols parameter when creating the WebSocket object, or the empty string if no connection is established.

readyState

val readyState: WebSocket.ReadyState

The WebSocket.readyState read-only property returns the current state of the WebSocket connection.

url

val url: String

The WebSocket.url read-only property returns the absolute URL of the WebSocket as resolved by the constructor.

Functions

fun close(code: Short = definedExternally, reason: String = definedExternally)

The WebSocket.close() method closes the already CLOSED, this method does nothing.

dispatchEvent

fun dispatchEvent(event: Event): Boolean

send

fun send(data: ArrayBufferLike)

fun send(data: ArrayBufferView<*>)

fun send(data: Blob)

fun send(data: String)

The WebSocket.send() method enqueues the specified data to be transmitted to the server over the WebSocket connection, increasing the value of bufferedAmount by the number of bytes needed to contain the data.

when

fun <T : Event> when(type: EventType<T>, options: ObservableEventListenerOptions? = definedExternally): Observable<T>