类 Socket

En

Socket encapsulates HTML5 WebSocket, allowing full-duplex real-time communication between server and client, and cross-domain communication. After establishing a connection, both server and Browser/Client Agent can actively send or receive text and binary data to each other.

  • To use Socket class methods, first create a Socket object using the constructor new Socket. Socket transmits and receives data asynchronously.
  • Event.OPEN event: dispatched after successful connection establishment.
  • Event.MESSAGE event: dispatched after receiving data.
  • Event.CLOSE event: dispatched after connection closed.
  • Event.ERROR event: dispatched after an error occurred.

Zh

Socket 封装了 HTML5 WebSocket，允许服务器端与客户端进行全双工（full-duplex）的实时通信，并且允许跨域通信。在建立连接后，服务器和 Browser/Client Agent 都能主动的向对方发送或接收文本和二进制数据。

  • 要使用Socket 类的方法，请先使用构造函数 new Socket 创建一个 Socket 对象。 Socket 以异步方式传输和接收数据。
  • Event.OPEN 事件：连接建立成功后调度。
  • Event.MESSAGE 事件：接收到数据后调度。
  • Event.CLOSE 事件：连接被关闭后调度。
  • Event.ERROR 事件：出现异常后调度。

层级 (查看层级一览)

构造函数

constructor

属性

disableInput protocols BIG_ENDIAN LITTLE_ENDIAN

访问器

connected endian input output

方法

cleanSocket close connect connectByUrl event flush hasListener off offAll offAllCaller on once send

构造函数

constructor

  • new Socket(
        host?: string,
        port?: number,
        byteClass?: new () => any,
        protocols?: any[],
        isSecure?: boolean,
    ): Socket

    参数

    • host: string = null

      The server address.

    • port: number = 0

      The server port.

    • byteClass: new () => any = null

      The Byte class used for receiving and sending data. If null, the Byte class will be used. You can also pass in a subclass of the Byte class.

    • protocols: any[] = null

      Subprotocol names. A string or an array of strings of subprotocol names.

    • isSecure: boolean = false

      Whether to use the WebSocket secure protocol wss, default (false) uses the ordinary protocol ws.

    返回 Socket

    En

    Create a new Socket object. The default byte order is Socket.BIG_ENDIAN. If no parameters are specified, a socket initially in a disconnected state will be created. If valid parameters are specified, it attempts to connect to the specified host and port.

    Zh

    创建新的 Socket 对象。默认字节序为 Socket.BIG_ENDIAN 。若未指定参数，将创建一个最初处于断开状态的套接字。若指定了有效参数，则尝试连接到指定的主机和端口。

属性

disableInput

disableInput: boolean = false

En

Whether to disable caching of data received from the server. If the transmitted data is in string format, it is recommended to set this to true to reduce binary conversion overhead.

Zh

是否禁用服务端发来的数据缓存。如果传输的数据为字符串格式，建议设置为true，减少二进制转换消耗。

protocols

protocols: any = []

En

Subprotocol names. A string or an array of strings of subprotocol names. Must be set before calling connect or connectByUrl, otherwise it will be invalid. If specified, the connection will only be established successfully if the server chooses one of these subprotocols, otherwise it will fail and dispatch an Event.ERROR event.

Zh

子协议名称。子协议名称字符串，或由多个子协议名称字符串构成的数组。必须在调用 connect 或者 connectByUrl 之前进行赋值，否则无效。指定后，只有当服务器选择了其中的某个子协议，连接才能建立成功，否则建立失败，派发 Event.ERROR 事件。

静态BIG_ENDIAN

BIG_ENDIAN: string = "bigEndian"

En

Big-endian byte order, where the high-order byte is stored in the low address. Also known as network byte order.

Zh

大端字节序，地址低位存储值的高位，地址高位存储值的低位。有时也称之为网络字节序。

静态LITTLE_ENDIAN

LITTLE_ENDIAN: string = "littleEndian"

En

Little-endian byte order, where the low-order byte is stored in the low address.

Zh

小端字节序，地址低位存储值的低位，地址高位存储值的高位。

访问器

connected

  • get connected(): boolean

    返回 boolean

    En

    Indicates whether this Socket object is currently connected.

    Zh

    表示此 Socket 对象目前是否已连接。

endian

input

output

  • get output(): any

    返回 any

    En

    The data in the buffer that needs to be sent to the server.

    Zh

    需要发送至服务端的缓冲区中的数据。

方法

cleanSocket

  • cleanSocket(): void

    返回 void

    En

    Clean up the Socket: close the Socket connection, remove event listeners, and reset the Socket.

    Zh

    清理Socket：关闭Socket连接，移除事件监听，重置Socket。

close

connect

  • connect(host: string, port: number, isSecure?: boolean): void

    参数

    • host: string

      The server address.

    • port: number

      The server port.

    • isSecure: boolean = false

      Whether to use the WebSocket secure protocol wss, default (false) uses the ordinary protocol ws.

    返回 void

    En

    Connect to the specified host and port.

    • Dispatches Event.OPEN on successful connection; Event.ERROR on connection failure; Event.CLOSE when the connection is closed; Event.MESSAGE when data is received. Except for Event.MESSAGE where the event parameter is the data content, other event parameters are native HTML DOM Event objects.

    Zh

    连接到指定的主机和端口。

    • 连接成功派发 Event.OPEN 事件；连接失败派发 Event.ERROR 事件；连接被关闭派发 Event.CLOSE 事件；接收到数据派发 Event.MESSAGE 事件； 除了 Event.MESSAGE 事件参数为数据内容，其他事件参数都是原生的 HTML DOM Event 对象。

connectByUrl

  • connectByUrl(url: string): void

    参数

    • url: string

      The server WebSocket URL to connect to. The URL is similar to ws://yourdomain:port.

    返回 void

    En

    Connect to the specified server WebSocket URL. The URL is similar to ws://yourdomain:port.

    • Dispatches Event.OPEN on successful connection; Event.ERROR on connection failure; Event.CLOSE when the connection is closed; Event.MESSAGE when data is received. Except for Event.MESSAGE where the event parameter is the data content, other event parameters are native HTML DOM Event objects.

    Zh

    连接到指定的服务端 WebSocket URL。 URL 类似 ws://yourdomain:port。

    • 连接成功派发 Event.OPEN 事件；连接失败派发 Event.ERROR 事件；连接被关闭派发 Event.CLOSE 事件；接收到数据派发 Event.MESSAGE 事件； 除了 Event.MESSAGE 事件参数为数据内容，其他事件参数都是原生的 HTML DOM Event 对象。

event

  • event(type: string, data?: any): boolean

    参数

    • type: string

      The type of event.

    • 可选data: any

      (Optional) Data to pass to the callback. If multiple parameters p1, p2, p3, ... need to be passed, use an array structure such as [p1, p2, p3, ...]. If a single parameter p needs to be passed and p is an array, use a structure such as [p]. For other single parameters p, you can directly pass parameter p. If data is Event.EMPTY, it means passing an Event object to the callback function. Note that it is not passing Event.TEMP, but an independent Event object.

    返回 boolean

    True if there are listeners for this event type, false otherwise.

    En

    Dispatch an event.

    Zh

    派发事件。

flush

hasListener

  • hasListener(type: string): boolean

    参数

    • type: string

      The type of event.

    返回 boolean

    True if a listener of the specified type is registered, false otherwise.

    En

    Check if the EventDispatcher object has any listeners registered for a specific type of event.

    Zh

    检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。

off

offAll

offAllCaller

on

  • on(type: string, listener: Function): EventDispatcher

    参数

    • type: string

      The type of event.

    • listener: Function

      The listener function.

    返回 EventDispatcher

    This EventDispatcher object.

    En

    Register an event listener object with the EventDispatcher object so that the listener receives event notifications.

    Zh

    使用 EventDispatcher 对象注册指定类型的事件侦听器对象，以使侦听器能够接收事件通知。

  • on(type: string, caller: any, listener: Function, args?: any[]): EventDispatcher

    参数

    • type: string

      The type of event.

    • caller: any

      The execution scope of the event listener function.

    • listener: Function

      The listener function.

    • 可选args: any[]

      (Optional) The callback parameters of the event listener function.

    返回 EventDispatcher

    This EventDispatcher object.

    En

    Register an event listener object with the EventDispatcher object so that the listener receives event notifications.

    Zh

    使用 EventDispatcher 对象注册指定类型的事件侦听器对象，以使侦听器能够接收事件通知。

once

  • once(type: string, listener: Function): EventDispatcher

    参数

    • type: string

      The type of event.

    • listener: Function

      The listener function.

    返回 EventDispatcher

    This EventDispatcher object.

    En

    Register an event listener object with the EventDispatcher object so that the listener receives event notifications. This event listener responds once and is automatically removed after the first call.

    Zh

    使用 EventDispatcher 对象注册指定类型的事件侦听器对象，以使侦听器能够接收事件通知，此侦听事件响应一次后自动移除。

  • once(
        type: string,
        caller: any,
        listener: Function,
        args?: any[],
    ): EventDispatcher

    参数

    • type: string

      The type of event.

    • caller: any

      The execution scope of the event listener function.

    • listener: Function

      The listener function.

    • 可选args: any[]

      (Optional) The callback parameters of the event listener function.

    返回 EventDispatcher

    This EventDispatcher object.

    En

    Register an event listener object with the EventDispatcher object so that the listener receives event notifications. This event listener responds once and is automatically removed after the first call.

    Zh

    使用 EventDispatcher 对象注册指定类型的事件侦听器对象，以使侦听器能够接收事件通知，此侦听事件响应一次后自动移除。

send

  • send(data: any): void

    参数

    • data: any

      The data to be sent, which can be either a String or an ArrayBuffer.

    返回 void

    En

    Send data to the server.

    Zh

    发送数据到服务器。

显示设置

成员可见性

目录

构造函数
属性
访问器
方法