API reference / @chanx-js/client / core / ConnectOptions

Interface: ConnectOptions<Address>

Defined in: packages/client/src/core/client.ts:20

Extends

• SocketOptions

Extended by

• ControllerOptions

Type Parameters

Type Parameter
Address extends string

Properties

closeDelay?

optional closeDelay?: number;

Defined in: packages/client/src/core/socket.ts:59

Grace period before a socket with no remaining consumers is actually closed. React's StrictMode unmounts and immediately remounts in development, which would otherwise tear down and rebuild the connection on every mount.

Inherited from

SocketOptions.closeDelay

---

heartbeat?

optional heartbeat?: false | HeartbeatOptions;

Defined in: packages/client/src/core/socket.ts:50

Ping on an interval and reconnect if nothing comes back. Off unless enabled: chanx consumers only answer ping when they declare a handler for it, and one that does not replies with an error frame every interval. connect() turns it on for channels whose schema declares ping/pong.

Inherited from

SocketOptions.heartbeat

---

maxQueuedFrames?

optional maxQueuedFrames?: number;

Defined in: packages/client/src/core/socket.ts:52

Cap on frames buffered while the socket is not yet open.

Inherited from

SocketOptions.maxQueuedFrames

---

onReconnectStop?

optional onReconnectStop?: (attempts) => void;

Defined in: packages/client/src/core/socket.ts:43

Parameters

Parameter	Type
attempts	number

Returns

void

Inherited from

SocketOptions.onReconnectStop

---

params?

optional params?: ParamsOf<Address>;

Defined in: packages/client/src/core/client.ts:21

---

protocols?

optional protocols?: string | string[];

Defined in: packages/client/src/core/socket.ts:30

Inherited from

SocketOptions.protocols

---

queryParams?

optional queryParams?: Record<string, string | number>;

Defined in: packages/client/src/core/socket.ts:31

Inherited from

SocketOptions.queryParams

---

reconnectAttempts?

optional reconnectAttempts?: number;

Defined in: packages/client/src/core/socket.ts:39

Inherited from

SocketOptions.reconnectAttempts

---

reconnectInterval?

optional reconnectInterval?: number | ((attempt) => number);

Defined in: packages/client/src/core/socket.ts:41

Fixed delay, or a function of the attempt number for backoff.

Inherited from

SocketOptions.reconnectInterval

---

retryOnError?

optional retryOnError?: boolean;

Defined in: packages/client/src/core/socket.ts:42

Inherited from

SocketOptions.retryOnError

---

share?

optional share?: boolean;

Defined in: packages/client/src/core/socket.ts:37

Share one socket per resolved URL. connect() defaults it to true for channels that carry topics and false otherwise: topic frames are routed per consumer, but on a plain channel every consumer of a shared socket sees every reply.

Inherited from

SocketOptions.share

---

shouldReconnect?

optional shouldReconnect?: (event) => boolean;

Defined in: packages/client/src/core/socket.ts:38

Parameters

Parameter	Type
event	{ code?: number; reason?: string; }
event.code?	number
event.reason?	string

Returns

boolean

Inherited from

SocketOptions.shouldReconnect

---

socketFactory?

optional socketFactory?: SocketFactory;

Defined in: packages/client/src/core/socket.ts:53

Inherited from

SocketOptions.socketFactory

---

validate?

optional validate?: ValidateConfig;

Defined in: packages/client/src/core/client.ts:22