Connection Status - CometChat Docs

AI Integration Quick Reference

// Get current status: "connecting" | "connected" | "disconnected"
const status = CometChat.getConnectionStatus();

// Listen for connection changes
CometChat.addConnectionListener("LISTENER_ID", new CometChat.ConnectionListener({
  onConnected: () => console.log("Connected"),
  inConnecting: () => console.log("Connecting..."),
  onDisconnected: () => console.log("Disconnected")
}));

// Cleanup
CometChat.removeConnectionListener("LISTENER_ID");

The CometChat SDK maintains a WebSocket connection to CometChat servers for real-time events. You can check the current connection state and listen for changes — useful for showing connectivity indicators in your UI or queuing operations while offline. When the connection drops, the SDK automatically attempts to reconnect, cycling through disconnected → connecting → connected.

Connection States

Value	Callback	Description
`"connected"`	`onConnected()`	SDK has an active connection to CometChat servers
`"connecting"`	`inConnecting()`	SDK is attempting to establish or re-establish a connection
`"disconnected"`	`onDisconnected()`	SDK is disconnected due to network issues or other errors
`"featureThrottled"`	`onFeatureThrottled()`	A feature has been throttled due to rate limiting

Get Current Status

Use getConnectionStatus() to check the current connection state at any time:

TypeScript
JavaScript

const connectionStatus: string = CometChat.getConnectionStatus();

const connectionStatus = CometChat.getConnectionStatus();

Listen for Connection Changes

Register a ConnectionListener to receive real-time connection state updates. We recommend adding this on app startup (e.g., in App.tsx) after CometChat.init() completes.

TypeScript
JavaScript

let listenerID: string = "UNIQUE_LISTENER_ID";
CometChat.addConnectionListener(
  listenerID,
  new CometChat.ConnectionListener({
    onConnected: () => {
      console.log("ConnectionListener => On Connected");
    },
    inConnecting: () => {
      console.log("ConnectionListener => In connecting");
    },
    onDisconnected: () => {
      console.log("ConnectionListener => On Disconnected");
    },
    onFeatureThrottled: () => {
      console.log("ConnectionListener => On Feature Throttled");
    },
    onConnectionError: () => {
      console.log("ConnectionListener => On Connection Error");
    },
  })
);

let listenerID = "UNIQUE_LISTENER_ID";
CometChat.addConnectionListener(
  listenerID,
  new CometChat.ConnectionListener({
    onConnected: () => {
      console.log("ConnectionListener => On Connected");
    },
    inConnecting: () => {
      console.log("ConnectionListener => In connecting");
    },
    onDisconnected: () => {
      console.log("ConnectionListener => On Disconnected");
    },
    onFeatureThrottled: () => {
      console.log("ConnectionListener => On Feature Throttled");
    },
    onConnectionError: () => {
      console.log("ConnectionListener => On Connection Error");
    },
  })
);

Always remove connection listeners when they’re no longer needed (e.g., on component unmount). Failing to remove listeners can cause memory leaks and duplicate event handling.

Next Steps

WebSocket Management

Manually manage WebSocket connections

All Real-Time Listeners

Complete reference for all SDK listeners

Setup SDK

Install and initialize the CometChat SDK

Key Concepts

Review the fundamental building blocks of CometChat

​Connection States

​Get Current Status

​Listen for Connection Changes

​Next Steps

WebSocket Management

All Real-Time Listeners

Setup SDK

Key Concepts

Connection States

Get Current Status

Listen for Connection Changes

Next Steps