/ fm / liveswitch / Client

Class: Client

fm.liveswitch.Client

A LiveSwitch client.

Hierarchy

Table of contents

Constructors

Methods

Constructors

constructor

+ new Client(gatewayUrl: string, applicationId: string): Client

Initializes a new instance of the [[fm.liveswitch.client]] class.

Parameters:

Name Type Description
gatewayUrl string The gateway URL.
applicationId string The application identifier.

Returns: Client

Inherited from: Dynamic

+ new Client(gatewayUrl: string, applicationId: string, userId: string): Client

Initializes a new instance of the [[fm.liveswitch.client]] class.

Parameters:

Name Type Description
gatewayUrl string The gateway URL.
applicationId string The application identifier.
userId string The user identifier, or null to auto-generate.

Returns: Client

+ new Client(gatewayUrl: string, applicationId: string, userId: string, deviceId: string): Client

Initializes a new instance of the [[fm.liveswitch.client]] class.

Parameters:

Name Type Description
gatewayUrl string The gateway URL.
applicationId string The application identifier.
userId string The user identifier, or null to auto-generate.
deviceId string The device identifier, or null to auto-generate.

Returns: Client

+ new Client(gatewayUrl: string, applicationId: string, userId: string, deviceId: string, clientId: string): Client

Initializes a new instance of the [[fm.liveswitch.client]] class.

Parameters:

Name Type Description
gatewayUrl string The gateway URL.
applicationId string The application identifier.
userId string The user identifier, or null to auto-generate.
deviceId string The device identifier, or null to auto-generate.
clientId string The client identifier, or null to auto-generate.

Returns: Client

+ new Client(gatewayUrl: string, applicationId: string, userId: string, deviceId: string, clientId: string, roles: string[]): Client

Initializes a new instance of the [[fm.liveswitch.client]] class.

Parameters:

Name Type Description
gatewayUrl string The gateway URL.
applicationId string The application identifier.
userId string The user identifier, or null to auto-generate.
deviceId string The device identifier, or null to auto-generate.
clientId string The client identifier, or null to auto-generate.
roles string[] The roles, if any.

Returns: Client

+ new Client(gatewayUrl: string, applicationId: string, userId: string, deviceId: string, clientId: string, roles: string[], region: string): Client

Initializes a new instance of the [[fm.liveswitch.client]] class.

Parameters:

Name Type Description
gatewayUrl string The gateway URL.
applicationId string The application identifier.
userId string The user identifier, or null to auto-generate.
deviceId string The device identifier, or null to auto-generate.
clientId string The client identifier, or null to auto-generate.
roles string[] The roles, if any.
region string The region, if any.

Returns: Client

Methods

addOnApplicationMessage

▸ addOnApplicationMessage(value: IAction2<ClientInfo, string>): void

Adds a handler that is raised when an application-scope message is received from the server. Parameters: - clientInfo - the sending client information - message - the message

Parameters:

Name Type
value IAction2<ClientInfo, string>

Returns: void

addOnDeviceMessage

▸ addOnDeviceMessage(value: IAction2<ClientInfo, string>): void

Adds a handler that is raised when a device-scope message is received from the server. Parameters: - clientInfo - the sending client information - message - the message

Parameters:

Name Type
value IAction2<ClientInfo, string>

Returns: void

addOnHttpRequestCreated

▸ addOnHttpRequestCreated(value: IAction1<HttpRequestCreatedArgs>): void

Adds a handler that is raised whenever an underlying HTTP request has been created and is about to be transferred to the server. This is a good place to add headers/cookies. For WebSocket streams, this will fire only once for the initial HTTP-based handshake.

Parameters:

Name Type
value IAction1<HttpRequestCreatedArgs>

Returns: void

addOnHttpResponseReceived

▸ addOnHttpResponseReceived(value: IAction1<HttpResponseReceivedArgs>): void

Adds a handler that is raised whenever an underlying HTTP response has been received and is about to be processed by the client. This is a good place to read headers/cookies. For WebSocket streams, this will fire only once for the initial HTTP-based handshake.

Parameters:

Name Type
value IAction1<HttpResponseReceivedArgs>

Returns: void

addOnMessage

▸ addOnMessage(value: IAction2<ClientInfo, string>): void

Adds a handler that is raised when a client-scope message is received from the server. Parameters: - clientInfo - the sending client information - message - the message

Parameters:

Name Type
value IAction2<ClientInfo, string>

Returns: void

addOnRemoteUpdate

▸ addOnRemoteUpdate(value: IAction2<ClientInfo, ClientInfo>): void

Adds a handler that is raised when the the client's config on the server has changed.

Parameters:

Name Type
value IAction2<ClientInfo, ClientInfo>

Returns: void

addOnStateChange

▸ addOnStateChange(value: IAction1<Client>): void

Adds a handler that is raised when the state changes.

Parameters:

Name Type
value IAction1<Client>

Returns: void

addOnUserMessage

▸ addOnUserMessage(value: IAction2<ClientInfo, string>): void

Adds a handler that is raised when a user-scope message is received from the server. Parameters: - clientInfo - the sending client information - message - the message

Parameters:

Name Type
value IAction2<ClientInfo, string>

Returns: void

closeAll

▸ closeAll(): Future<Object>

Closes all active connections in all channels.

Returns: Future<Object>

fmliveswitchClientInit

▸ PrivatefmliveswitchClientInit(): void

Returns: void

getApplicationId

▸ getApplicationId(): string

Gets the application identifier.

Returns: string

getAutoUnregister

▸ getAutoUnregister(): boolean

Gets whether to unregister automatically when the page unloads.

Returns: boolean

getChannels

▸ getChannels(): Channel[]

Gets an array of joined channels.

Returns: Channel[]

getConfig

▸ getConfig(): ClientConfig

Gets the current configuration.

Returns: ClientConfig

getDeviceAlias

▸ getDeviceAlias(): string

Gets the device alias. Cannot be set after registration, use the 'Update' method instead.

Returns: string

getDeviceId

▸ getDeviceId(): string

Gets the device identifier.

Returns: string

getDisableCors

▸ getDisableCors(): boolean

Gets a value indicating whether to disable the cross-origin resource sharing (CORS) transport.

Returns: boolean

getDisableJsonp

▸ getDisableJsonp(): boolean

Gets a value indicating whether to disable the JSON-P transport.

Returns: boolean

getDisablePostMessage

▸ getDisablePostMessage(): boolean

Gets a value indicating whether to disable the postMessage transport.

Returns: boolean

getDisableWebSockets

▸ getDisableWebSockets(): boolean

Gets whether to disable WebSocket protocol support and use long-polling, even if the server is capable of accepting WebSocket requests.

Returns: boolean

getDynamicProperties

▸ getDynamicProperties(): Hash<string, Object>

Gets the dynamic properties on this instance.

Returns: Hash<string, Object>

Inherited from: Dynamic

getDynamicValue

▸ getDynamicValue(key: string): Object

Gets a property value from the local cache.

Parameters:

Name Type Description
key string The property key. This key is used internally only, but should be namespaced to avoid conflict with third-party extensions.

Returns: Object

The stored value, if found; otherwise null.

Inherited from: Dynamic

getExternalId

▸ getExternalId(): string

Gets the external client identifier.

Returns: string

getForceJsonp

▸ getForceJsonp(): boolean

Gets a value indicating whether to force the JSON-P transport.

Returns: boolean

getGatewayUrl

▸ getGatewayUrl(): string

Gets the gateway URL.

Returns: string

getId

▸ getId(): string

Gets the client identifier.

Returns: string

getInfo

▸ getInfo(): ClientInfo

Gets the client info.

Returns: ClientInfo

getMessageBytesReceived

▸ getMessageBytesReceived(): number

Gets the number of message bytes received.

Returns: number

getMessageBytesSent

▸ getMessageBytesSent(): number

Gets the number of message bytes sent.

Returns: number

getMessagesReceived

▸ getMessagesReceived(): number

Gets the number of messages received.

Returns: number

getMessagesSent

▸ getMessagesSent(): number

Gets the number of messages sent.

Returns: number

getRegion

▸ getRegion(): string

Gets the region.

Returns: string

getRequestMaxRetries

▸ getRequestMaxRetries(): number

Gets the maximum number of retries allowed for a standard request.

Returns: number

getRequestTimeout

▸ getRequestTimeout(): number

Gets the number of milliseconds to wait for a standard request to return a response before it is aborted and another request is attempted. Defaults to 15000 (15 seconds).

Returns: number

getRoles

▸ getRoles(): string[]

Gets the roles.

Returns: string[]

getState

▸ getState(): ClientState

Gets the state.

Returns: ClientState

getTag

▸ getTag(): string

Gets the tag. Cannot be set after registration, use the 'Update' method instead.

Returns: string

getTypeString

▸ getTypeString(): string

Returns: string

Overrides: Dynamic

getUnregisterException

▸ getUnregisterException(): Exception

Gets the unregister exception, which is set if registration is reset abnormally.

Returns: Exception

getUserAlias

▸ getUserAlias(): string

Gets the user alias. Cannot be set after registration, use the 'Update' method instead.

Returns: string

getUserId

▸ getUserId(): string

Gets the user identifier.

Returns: string

join

▸ join(channelId: string, token: string): Future<Channel>

Joins a channel.

Parameters:

Name Type Description
channelId string The channel identifier.
token string The auth token.

Returns: Future<Channel>

A future with the joined channel.

▸ join(token: string): Future<Channel>

Joins a channel.

Parameters:

Name Type Description
token string The auth token.

Returns: Future<Channel>

A future with the joined channel.

leave

▸ leave(channelId: string): Future<Channel>

Leaves a channel.

Parameters:

Name Type Description
channelId string The channel identifier.

Returns: Future<Channel>

register

▸ register(token: string): Future<Channel[]>

Registers with the signalling server.

Parameters:

Name Type Description
token string The auth token.

Returns: Future<Channel[]>

A future with an array of initial channels as instructed by the auth token.

removeOnApplicationMessage

▸ removeOnApplicationMessage(value: IAction2<ClientInfo, string>): void

Removes a handler that is raised when an application-scope message is received from the server. Parameters: - clientInfo - the sending client information - message - the message

Parameters:

Name Type
value IAction2<ClientInfo, string>

Returns: void

removeOnDeviceMessage

▸ removeOnDeviceMessage(value: IAction2<ClientInfo, string>): void

Removes a handler that is raised when a device-scope message is received from the server. Parameters: - clientInfo - the sending client information - message - the message

Parameters:

Name Type
value IAction2<ClientInfo, string>

Returns: void

removeOnHttpRequestCreated

▸ removeOnHttpRequestCreated(value: IAction1<HttpRequestCreatedArgs>): void

Removes a handler that is raised whenever an underlying HTTP request has been created and is about to be transferred to the server. This is a good place to add headers/cookies. For WebSocket streams, this will fire only once for the initial HTTP-based handshake.

Parameters:

Name Type
value IAction1<HttpRequestCreatedArgs>

Returns: void

removeOnHttpResponseReceived

▸ removeOnHttpResponseReceived(value: IAction1<HttpResponseReceivedArgs>): void

Removes a handler that is raised whenever an underlying HTTP response has been received and is about to be processed by the client. This is a good place to read headers/cookies. For WebSocket streams, this will fire only once for the initial HTTP-based handshake.

Parameters:

Name Type
value IAction1<HttpResponseReceivedArgs>

Returns: void

removeOnMessage

▸ removeOnMessage(value: IAction2<ClientInfo, string>): void

Removes a handler that is raised when a client-scope message is received from the server. Parameters: - clientInfo - the sending client information - message - the message

Parameters:

Name Type
value IAction2<ClientInfo, string>

Returns: void

removeOnRemoteUpdate

▸ removeOnRemoteUpdate(value: IAction2<ClientInfo, ClientInfo>): void

Removes a handler that is raised when the the client's config on the server has changed.

Parameters:

Name Type
value IAction2<ClientInfo, ClientInfo>

Returns: void

removeOnStateChange

▸ removeOnStateChange(value: IAction1<Client>): void

Removes a handler that is raised when the state changes.

Parameters:

Name Type
value IAction1<Client>

Returns: void

removeOnUserMessage

▸ removeOnUserMessage(value: IAction2<ClientInfo, string>): void

Removes a handler that is raised when a user-scope message is received from the server. Parameters: - clientInfo - the sending client information - message - the message

Parameters:

Name Type
value IAction2<ClientInfo, string>

Returns: void

sendMessage

▸ sendMessage(message: string): Future<Object>

Sends a message to the server with no delivery.

Parameters:

Name Type Description
message string The message to be sent.

Returns: Future<Object>

setAutoUnregister

▸ setAutoUnregister(value: boolean): void

Sets whether to unregister automatically when the page unloads.

Parameters:

Name Type
value boolean

Returns: void

setDeviceAlias

▸ setDeviceAlias(value: string): void

Sets the device alias. Cannot be set after registration, use the 'Update' method instead.

Parameters:

Name Type
value string

Returns: void

setDisableCors

▸ setDisableCors(value: boolean): void

Sets a value indicating whether to disable the cross-origin resource sharing (CORS) transport.

Parameters:

Name Type
value boolean

Returns: void

setDisableJsonp

▸ setDisableJsonp(value: boolean): void

Sets a value indicating whether to disable the JSON-P transport.

Parameters:

Name Type
value boolean

Returns: void

setDisablePostMessage

▸ setDisablePostMessage(value: boolean): void

Sets a value indicating whether to disable the postMessage transport.

Parameters:

Name Type
value boolean

Returns: void

setDisableWebSockets

▸ setDisableWebSockets(value: boolean): void

Sets whether to disable WebSocket protocol support and use long-polling, even if the server is capable of accepting WebSocket requests.

Parameters:

Name Type
value boolean

Returns: void

setDynamicValue

▸ setDynamicValue(key: string, value: Object): void

Sets a property value in the local cache.

Parameters:

Name Type Description
key string The property key. This key is used internally only, but should be namespaced to avoid conflict with third-party extensions.
value Object The property value. This can be any object that needs to be stored for future use.

Returns: void

Inherited from: Dynamic

setExternalId

▸ setExternalId(value: string): void

Sets the external client identifier.

Parameters:

Name Type
value string

Returns: void

setForceJsonp

▸ setForceJsonp(value: boolean): void

Sets a value indicating whether to force the JSON-P transport.

Parameters:

Name Type
value boolean

Returns: void

setRequestMaxRetries

▸ setRequestMaxRetries(value: number): void

Sets the maximum number of retries allowed for a standard request.

Parameters:

Name Type
value number

Returns: void

setRequestTimeout

▸ setRequestTimeout(value: number): void

Sets the number of milliseconds to wait for a standard request to return a response before it is aborted and another request is attempted. Defaults to 15000 (15 seconds).

Parameters:

Name Type
value number

Returns: void

setTag

▸ setTag(value: string): void

Sets the tag. Cannot be set after registration, use the 'Update' method instead.

Parameters:

Name Type
value string

Returns: void

setUserAlias

▸ setUserAlias(value: string): void

Sets the user alias. Cannot be set after registration, use the 'Update' method instead.

Parameters:

Name Type
value string

Returns: void

unregister

▸ unregister(): Future<Object>

Unregisters with the signalling server.

Returns: Future<Object>

A future that resolves when successfully unregistered.

unsetDynamicValue

▸ unsetDynamicValue(key: string): boolean

Unsets a property value in the local cache.

Parameters:

Name Type Description
key string The property key. This key is used internally only, but should be namespaced to avoid conflict with third-party extensions.

Returns: boolean

true if the value was removed; otherwise, false.

Inherited from: Dynamic

update

▸ update(clientConfig: ClientConfig): Future<Object>

Updates your client configuration.

Parameters:

Name Type Description
clientConfig ClientConfig The new client configuration.

Returns: Future<Object>