SocketIOClient

open class SocketIOClient : NSObject, SocketIOClientSpec, SocketEngineClient, SocketParsable

The main class for SocketIOClientSwift.

NOTE: The client is not thread/queue safe, all interaction with the socket should be done on the handleQueue

Represents a socket.io-client. Most interaction with socket.io will be through this class.

  • The engine for this client.

    Declaration

    Swift

    public private(set) var engine: SocketEngineSpec?
  • The status of this client.

    Declaration

    Swift

    public private(set) var status = SocketIOClientStatus.notConnected
  • If true then every time connect is called, a new engine will be created.

    Declaration

    Swift

    public var forceNew = false
  • The queue that all interaction with the client should occur on. This is the queue that event handlers are called on.

    Declaration

    Swift

    public var handleQueue = DispatchQueue.main
  • nsp

    The namespace for this client.

    Declaration

    Swift

    public var nsp = "/"
  • The configuration for this client.

    Declaration

    Swift

    public var config: SocketIOClientConfiguration
  • If true, this client will try and reconnect on any disconnects.

    Declaration

    Swift

    public var reconnects = true
  • The number of seconds to wait before attempting to reconnect.

    Declaration

    Swift

    public var reconnectWait = 10
  • sid

    The session id of this client.

    Declaration

    Swift

    public var sid: String?
  • The URL of the socket.io server.

    If changed after calling init, forceNew must be set to true, or it will only connect to the url set in the init.

    Declaration

    Swift

    public var socketURL: URL
  • Type safe way to create a new SocketIOClient. opts can be omitted.

    Declaration

    Swift

    public init(socketURL: URL, config: SocketIOClientConfiguration = [])

    Parameters

    socketURL

    The url of the socket.io server.

    config

    The config for this socket.

  • Not so type safe way to create a SocketIOClient, meant for Objective-C compatiblity. If using Swift it’s recommended to use init(socketURL: NSURL, options: Set<SocketIOClientOption>)

    Declaration

    Swift

    public convenience init(socketURL: NSURL, config: NSDictionary?)

    Parameters

    socketURL

    The url of the socket.io server.

    config

    The config for this socket.

  • Connect to the server.

    Declaration

    Swift

    open func connect()
  • Connect to the server. If we aren’t connected after timeoutAfter seconds, then withHandler is called.

    Declaration

    Swift

    open func connect(timeoutAfter: Double, withHandler handler: (() -> ())?)

    Parameters

    timeoutAfter

    The number of seconds after which if we are not connected we assume the connection has failed. Pass 0 to never timeout.

    withHandler

    The handler to call when the client fails to connect.

  • Disconnects the socket.

    Declaration

    Swift

    open func disconnect()
  • Send an event to the server, with optional data items.

    If an error occurs trying to transform items into their socket representation, a SocketClientEvent.error will be emitted. The structure of the error data is [eventName, items, theError]

    Declaration

    Swift

    open func emit(_ event: String, _ items: SocketData...)

    Parameters

    event

    The event to send.

    items

    The items to send with this event. May be left out.

  • Same as emit, but meant for Objective-C

    Declaration

    Swift

    open func emit(_ event: String, with items: [Any])

    Parameters

    event

    The event to send.

    with

    The items to send with this event. May be left out.

  • Sends a message to the server, requesting an ack.

    NOTE: It is up to the server send an ack back, just calling this method does not mean the server will ack. Check that your server’s api will ack the event being sent.

    If an error occurs trying to transform items into their socket representation, a SocketClientEvent.error will be emitted. The structure of the error data is [eventName, items, theError]

    Example:

    socket.emitWithAck("myEvent", 1).timingOut(after: 1) {data in
        ...
    }
    

    Declaration

    Swift

    open func emitWithAck(_ event: String, _ items: SocketData...) -> OnAckCallback

    Parameters

    event

    The event to send.

    items

    The items to send with this event. May be left out.

    Return Value

    An OnAckCallback. You must call the timingOut(after:) method before the event will be sent.

  • Same as emitWithAck, but for Objective-C

    NOTE: It is up to the server send an ack back, just calling this method does not mean the server will ack. Check that your server’s api will ack the event being sent.

    Example:

    socket.emitWithAck("myEvent", with: [1]).timingOut(after: 1) {data in
        ...
    }
    

    Declaration

    Swift

    open func emitWithAck(_ event: String, with items: [Any]) -> OnAckCallback

    Parameters

    event

    The event to send.

    with

    The items to send with this event. Use [] to send nothing.

    Return Value

    An OnAckCallback. You must call the timingOut(after:) method before the event will be sent.

  • Called when the engine closes.

    Declaration

    Swift

    open func engineDidClose(reason: String)

    Parameters

    reason

    The reason that the engine closed.

  • Called when the engine errors.

    Declaration

    Swift

    open func engineDidError(reason: String)

    Parameters

    reason

    The reason the engine errored.

  • Called when the engine opens.

    Declaration

    Swift

    open func engineDidOpen(reason: String)

    Parameters

    reason

    The reason the engine opened.

  • Causes an event to be handled, and any event handlers for that event to be called.

    Declaration

    Swift

    open func handleEvent(_ event: String, data: [Any], isInternalMessage: Bool, withAck ack: Int = -1)

    Parameters

    event

    The event that is to be handled.

    data

    the data associated with this event.

    isInternalMessage

    If true event handlers for this event will be called regardless of status.

    withAck

    The ack number for this event. May be left out.

  • Leaves nsp and goes back to the default namespace.

    Declaration

    Swift

    open func leaveNamespace()
  • Joins namespace.

    Do not use this to join the default namespace. Instead call leaveNamespace.

    Declaration

    Swift

    open func joinNamespace(_ namespace: String)

    Parameters

    namespace

    The namespace to join.

  • Removes handler(s) based on an event name.

    If you wish to remove a specific event, call the off(id:) with the UUID received from its on call.

    Declaration

    Swift

    open func off(_ event: String)

    Parameters

    event

    The event to remove handlers for.

  • Removes a handler with the specified UUID gotten from an on or once

    If you want to remove all events for an event, call the off off(_:) method with the event name.

    Declaration

    Swift

    open func off(id: UUID)

    Parameters

    id

    The UUID of the handler you wish to remove.

  • Adds a handler for an event.

    Declaration

    Swift

    open func on(_ event: String, callback: @escaping NormalCallback) -> UUID

    Parameters

    event

    The event name for this handler.

    callback

    The callback that will execute when this event is received.

    Return Value

    A unique id for the handler that can be used to remove it.

  • Adds a handler for a client event.

    Example:

    socket.on(clientEvent: .connect) {data, ack in
        ...
    }
    

    Declaration

    Swift

    open func on(clientEvent event: SocketClientEvent, callback: @escaping NormalCallback) -> UUID

    Parameters

    event

    The event for this handler.

    callback

    The callback that will execute when this event is received.

    Return Value

    A unique id for the handler that can be used to remove it.

  • Adds a single-use handler for an event.

    Declaration

    Swift

    open func once(_ event: String, callback: @escaping NormalCallback) -> UUID

    Parameters

    event

    The event name for this handler.

    callback

    The callback that will execute when this event is received.

    Return Value

    A unique id for the handler that can be used to remove it.

  • Adds a handler that will be called on every event.

    Declaration

    Swift

    open func onAny(_ handler: @escaping (SocketAnyEvent) -> ())

    Parameters

    handler

    The callback that will execute whenever an event is received.

  • Called when the engine has a message that must be parsed.

    Declaration

    Swift

    public func parseEngineMessage(_ msg: String)

    Parameters

    msg

    The message that needs parsing.

  • Called when the engine receives binary data.

    Declaration

    Swift

    public func parseEngineBinaryData(_ data: Data)

    Parameters

    data

    The data the engine received.

  • Tries to reconnect to the server.

    This will cause a disconnect event to be emitted, as well as an reconnectAttempt event.

    Declaration

    Swift

    open func reconnect()
  • Removes all handlers. Can be used after disconnecting to break any potential remaining retain cycles.

    Declaration

    Swift

    open func removeAllHandlers()