@jaraxa/nc-wsclient v3.0.5
ws-client
Description
- Netcomposer WebSocket wrapper using react-use-websocket and the Event Bus design pattern
- Provides connection, communication and event subscription
WS Communication
Dependencies
API
- WSClientProvider: provider that allows the use of the
useWSClient
hook. Params:wsUrl
(WS url to connect to),netcomposerAppPrefix
(app identifier used as prefix),logMode
('verbose', 'minimalist', 'only-error' or 'off'),keepAliveTimeout
(max time that the client can be idle to keep alive the connection with the server. Optional, defaults to 5 seconds),ackTimeout
(max time to consider a WS ack message as slow. Optional, defaults to 5 seconds) &resultTimeout
(max time to consider a WS result message as slow. Optional, defaults to 10 seconds). Client code must be wrapped by it. - useWSClient: hook that give access through destructuring to
connectionStatus
,sendCommand
,connect
&disconnect
.- connectionStatus: variable that provides the state of the WS connection. One of
Connecting
,Open
,Closing
,Closed
orUninstantiated
. Type can be imported asConnectionStatus
. - sendCommand: function that allows message sending to the WS. Accepts a param of type
Message
and returns a Promise.Message
type can be imported.
- connectionStatus: variable that provides the state of the WS connection. One of
- useEventSubscription: hook that provides a subscribe on mount and unsubscribe on unmount mechanism. Params:
eventKey
(the event key this subscription is associated to) &eventHandler
(the eventHandler to call in response to that event).
important:
useEventSubscription eventHandler
must be wrapped inReact.useCallback
to maintain referential stability
Log Modes
Verbose
- Ack
- Ping
- Command
- Result
- Event
- Error
Minimalist
- Command
- Result
- Event
- Error
Only Error
- Result Error
- Error
Off
- Nothing
Examples
TODO
Resources
1 month ago
1 month ago
1 month ago
1 month ago
4 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
6 months ago
6 months ago
8 months ago
8 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
5 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
5 months ago
6 months ago
6 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago