Class TocketClientBrowser<S>

Tocket client for browsers. Designed to be bundled.

Type Parameters

S extends SocketDefinition = DefaultSocket

Definition object for the functionality of the Socket.

Hierarchy

TocketClientBase<S>
- TocketClientBrowser

constructor

new TocketClientBrowser<S>(mainURL, data?, timeout?, trapServer?, mainServerTimeout?, mainServerInit?, mainServerLogging?): TocketClientBrowser<S>
Type Parameters
- S extends SocketDefinition = DefaultSocket
Parameters
- mainURL: string
- data: {
  [K in string]: Serializable
  } = ...
- timeout: number = 1500
- trapServer: boolean = false
- mainServerTimeout: number = 1500
- mainServerInit: boolean = true
- Optional mainServerLogging: LoggingTypes
Returns TocketClientBrowser<S>
Overrides TocketClientBase.constructor
- Defined in browser/TocketClientBrowser.ts:10

`Readonly` defaultCustomDataHandler

defaultCustomDataHandler: ((handler) => any)

Type declaration

- (handler): any
- Parameters
  - handler: Handler<any, any>
  Returns any

`Readonly` defaultIdentityHandler

defaultIdentityHandler: ((handler) => any)

Type declaration

- (handler): any
- Parameters
  - handler: Handler<any, any>
  Returns any

getCustomData

getCustomData<K>(key?): K extends Sk<S["data"] & {
        id: string;
    }>
    ? (S["data"] & {
        id: string;
    })[K]
    : S["data"]
Access the CustomData object of this Socket.
Type Parameters
- K extends string
Parameters
- Optional key: K
  
  The key of the CustomData property to fetch. If left out the entire CustomData Object is returned.
Returns K extends Sk<S["data"] & {
        id: string;
    }>
    ? (S["data"] & {
        id: string;
    })[K]
    : S["data"]
Either the content of the CustomData property or the CustomData Object
Inherited from TocketClientBase.getCustomData
- Defined in base/TocketBase.ts:201

getPromiseId

getPromiseId(requestFilter): undefined | string
Parameters
- requestFilter: Partial<SocketRequest>
Returns undefined | string
Inherited from TocketClientBase.getPromiseId
- Defined in base/TocketBase.ts:60

removeConnection

removeConnection(name): boolean
Removes a server connection from the client.
Parameters
- name: string
  
  The name of the Server
Returns boolean
Inherited from TocketClientBase.removeConnection
- Defined in base/TocketClientBase.ts:44

Primary Controls

launch

launch: SocketMethods<S> = ...

genericMessageInterceptor

genericMessageInterceptor(socket): TrapFunction
Generics message interceptor
Parameters
- socket: SocketWrapper<S>
  
  The Socket to target.
Returns TrapFunction
Either the name of the Communication preset that processed the message or true.
Used to decide if the message should be forwarded to the socket's default handling function if available.
Inherited from TocketClientBase.genericMessageInterceptor
- Defined in base/TocketClientBase.ts:78

getConnections

getConnections(arg?): SocketWrapper<S>[]
Fetch all or a subset of current connections of the Socket, optionally narrowed by a filter.
Parameters
- Optional arg: ConnectionFilter<NonNullable<Connector<S>>>
  
  a Filter for the connections to be fetched. If left empty, all connections are returned.
Returns SocketWrapper<S>[]
Inherited from TocketClientBase.getConnections
- Defined in base/TocketBase.ts:173

listPresets

listPresets(): string[]
List all registered communication presets

Returns string[]
Array of preset names
Inherited from TocketClientBase.listPresets
- Defined in base/TocketBase.ts:80

onInit

onInit(): any
Function to be executed when connection to the main webSocket is established

Returns any
Inherited from TocketClientBase.onInit
- Defined in base/TocketClientBase.ts:92

register

register<N>(name, handlerName?, defaultTarget?, timeout?): Communication<S["presets"][N], NonNullable<Connector<S>>>
Registers a communication preset.
Type Parameters
- N extends string
Parameters
- name: N
  
  identifier of this preset.
- Optional handlerName: string
  
  name of the handler function on the target Socket this should process the messages
- Optional defaultTarget: ConnectionFilter<NonNullable<Connector<S>>>
  
  identifier of the Socket the communication should target. uses the 'main' socket by default
- timeout: number = ...
Returns Communication<S["presets"][N], NonNullable<Connector<S>>>
the generated Communication preset.
Inherited from TocketClientBase.register
- Defined in base/TocketBase.ts:211

registerSocket

registerSocket(name, source, timeout?, initialized?, logging?): SocketWrapper<S>
Registers socket
Parameters
- name: string
  
  the name of the targeted endpoint.
- source: string | SocketLike
  
  WebSocket ws or wss URL
- timeout: number = ...
  
  How long to wait for the endpoint to respond
- Optional initialized: boolean
  
  Should the connection be initialized at a later time?
- Optional logging: LoggingTypes
  
  which messages should be logged?
Returns SocketWrapper<S>
The created SocketWrapper
Inherited from TocketClientBase.registerSocket
- Defined in base/TocketClientBase.ts:58

removeSocket

removeSocket(name): boolean
Removes a Socket from the TocketClientBase#connections map.
Parameters
- name: string
  
  The name of the connection to remove.
Returns boolean
true if the Socket was removed, false if it didn't exist.
Inherited from TocketClientBase.removeSocket
- Defined in base/TocketClientBase.ts:68

General Properties

clientID

clientID: undefined | string = undefined

Client id generated by the server, empty in the Base and Server versions of the class

`Protected` customData

customData: {
[K in string]: Serializable
} = ...

`Private` proxySet

proxySet: boolean = false

true if we have hijacked window.webSocket object to intercept connections

timeout

timeout: number = 1500

Internal Methods

`Protected` _launch

_launch<N>(name, content?, targetFilter?): DefBack<S, N, "returns">
Launch a previously registered communication preset.
Type Parameters
- N extends string
Parameters
- name: N
  
  the name of the communication preset to start
- Optional content: DefBack<S, N, "content">
  
  the data used to initialize the connection.
- Optional targetFilter: ConnectionFilter<NonNullable<Connector<S>>>
  
  the identifier of the endpoint this should receive this message
Returns DefBack<S, N, "returns">
Inherited from TocketClientBase._launch
- Defined in base/TocketBase.ts:225

generateInterface

generateInterface<N>(presetName, handler, initialTarget, pID?): Handler<S["presets"][N], NonNullable<Connector<S>>>
Providing the communication method with smart and typed parameter functions.
Type Parameters
- N extends string
Parameters
- presetName: N
  
  Name of preset
- handler: Extract<keyof S["presets"], string>
  
  handler name
- initialTarget: ConnectionFilter<NonNullable<Connector<S>>>
  
  targetName
- Optional pID: string
  
  PID instance
Returns Handler<S["presets"][N], NonNullable<Connector<S>>>
The finished method handler
Inherited from TocketClientBase.generateInterface
- Defined in base/TocketBase.ts:122

makeUUID

makeUUID(): string
Returns string
Overrides TocketClientBase.makeUUID
- Defined in browser/TocketClientBrowser.ts:56

setCustomData

setCustomData(property, value): void
Modifies custom data on a Socket or Client. All connected Sockets and Clients receive the change immediately.
Parameters
- property: Extract<keyof S["data"], string>
  
  name of the property to set
- value: Serializable
  
  new value of the property
Returns void
Inherited from TocketClientBase.setCustomData
- Defined in base/TocketBase.ts:192

`Private` socketProxy

socketProxy(): boolean
Method to modify the window.WebSocket object. Only executed if there is at least one entry in the trapMap.

Returns boolean
- Defined in browser/TocketClientBrowser.ts:17

Internal Data

`Protected` connections

connections: Map<string, SocketWrapper<S>> = ...

`Protected` presets

presets: {
[K in string]: Communication<S["presets"][K], NonNullable<Connector<S>>>
} = ...

Map holding all communication presets registered to the Socket

`Protected` promiseMap

promiseMap: Map<string, PromiseData> = ...

`Private` `Readonly` trapMap

trapMap: Map<string | RegExp, {
repeatable: boolean;
resolver: ((captive) => void);
}> = ...

Type declaration

repeatable: boolean
resolver: ((captive) => void)
- - (captive): void
  - Parameters
    - captive: WebSocket
    Returns void

Primary Methods

registerSocketTrap

registerSocketTrap(name, sourceURL, timeout?, logging?, repeatable?): undefined | SocketTrapper<S>
Parameters
- name: string
- sourceURL: string | RegExp
- Optional timeout: number
- Optional logging: LoggingTypes
- repeatable: boolean = false
Returns undefined | SocketTrapper<S>
- Defined in browser/TocketClientBrowser.ts:47

Class TocketClientBrowser<S>

Type Parameters

S extends SocketDefinition = DefaultSocket

Hierarchy

Index

Primary Controls

General Properties

Internal Methods

Internal Data

Primary Methods

constructor

Type Parameters

S extends SocketDefinition = DefaultSocket

Parameters

mainURL: string

data: { [K in string]: Serializable} = ...

timeout: number = 1500

trapServer: boolean = false

mainServerTimeout: number = 1500

mainServerInit: boolean = true

Optional mainServerLogging: LoggingTypes

Returns TocketClientBrowser<S>

Readonly defaultCustomDataHandler

Type declaration

Parameters

handler: Handler<any, any>

Returns any

Readonly defaultIdentityHandler

Type declaration

Parameters

handler: Handler<any, any>

Returns any

getCustomData

Type Parameters

K extends string

Parameters

Optional key: K

Returns K extends Sk<S["data"] & { id: string; }> ? (S["data"] & { id: string; })[K] : S["data"]

getPromiseId

Parameters

requestFilter: Partial<SocketRequest>

Returns undefined | string

removeConnection

Parameters

name: string

Returns boolean

Primary Controls

launch

genericMessageInterceptor

Parameters

socket: SocketWrapper<S>

Returns TrapFunction

getConnections

Parameters

Optional arg: ConnectionFilter<NonNullable<Connector<S>>>

Returns SocketWrapper<S>[]

listPresets

Returns string[]

onInit

Returns any

register

Type Parameters

N extends string

Parameters

name: N

Optional handlerName: string

Optional defaultTarget: ConnectionFilter<NonNullable<Connector<S>>>

timeout: number = ...

Returns Communication<S["presets"][N], NonNullable<Connector<S>>>

registerSocket

Parameters

name: string

source: string | SocketLike

timeout: number = ...

Optional initialized: boolean

Optional logging: LoggingTypes

Returns SocketWrapper<S>

removeSocket

Parameters

name: string

data: {
[K in string]: Serializable
} = ...

`Optional` mainServerLogging: LoggingTypes

`Readonly` defaultCustomDataHandler

`Readonly` defaultIdentityHandler

`Optional` key: K

Returns K extends Sk<S["data"] & {
id: string;
}>
? (S["data"] & {
id: string;
})[K]
: S["data"]

`Optional` arg: ConnectionFilter<NonNullable<Connector<S>>>

`Optional` handlerName: string

`Optional` defaultTarget: ConnectionFilter<NonNullable<Connector<S>>>

`Optional` initialized: boolean

`Optional` logging: LoggingTypes

`Protected` customData

`Private` proxySet

`Protected` _launch

`Optional` content: DefBack<S, N, "content">

`Optional` targetFilter: ConnectionFilter<NonNullable<Connector<S>>>

`Optional` pID: string

`Private` socketProxy

`Protected` connections

`Protected` presets

`Protected` promiseMap

`Private` `Readonly` trapMap

`Optional` timeout: number

`Optional` logging: LoggingTypes