Block Users

AI Integration Quick Reference

Field	Value
Package	`@cometchat/chat-sdk-react-native`
Import	`import { CometChat } from "@cometchat/chat-sdk-react-native";`
Key Methods	`blockUsers()`, `unblockUsers()`
Key Classes	`BlockedUsersRequest`, `BlockedUsersRequestBuilder`, `CometChatException`, `User`
Prerequisites	SDK initialized via `CometChat.init()` and a logged-in user via `CometChat.login()`
Primary output	`Promise<Object>` — a map of UID → `"success"` / failure reason; rejects with `CometChatException`
Constraints	Both methods take an array of UIDs, never a bare string. Blocking is one-directional: the blocked user is not told.
Related	Retrieve Users · User Management · User Presence
Full reference	`User` · `CometChatException`

// Block users
await CometChat.blockUsers(["UID1", "UID2"]);

// Unblock users
await CometChat.unblockUsers(["UID1", "UID2"]);

// Get blocked users list
let request = new CometChat.BlockedUsersRequestBuilder().setLimit(30).build();
let blockedUsers = await request.fetchNext();

Directions: BLOCKED_BY_ME | HAS_BLOCKED_ME | BOTH (default)

Blocking a user prevents all communication between them and the logged-in user — messages, calls, and presence updates are all suppressed. You can block and unblock users by UID, and fetch the blocked users list with filtering and pagination.

Block users to prevent all communication with them. Use blockUsers() with an array of UIDs.

TypeScript
JavaScript

const usersList: String[] = ["UID1", "UID2", "UID3"];

CometChat.blockUsers(usersList).then(
  (list: Object) => {
      console.log("users list blocked", { list });
  }, (error: CometChat.CometChatException) => {
      console.log("Blocking user fails with error", error);
  }
);

const usersList = ["UID1", "UID2", "UID3"];

CometChat.blockUsers(usersList).then(
list => {
  console.log("users list blocked", { list });
}, error => {
  console.log("Blocking user fails with error", error);
}
);

Alternatively, you can use the async/await syntax:

const usersList = ["UID1", "UID2", "UID3"];

try {
  const list = await CometChat.blockUsers(usersList);
  console.log("users list blocked", { list });
} catch (error) {
  console.log("Blocking user fails with error", error);
}

Returns an object with UIDs as keys and "success" or "fail" as values. Each User in the request is processed independently.

Unblock Users

Unblock previously blocked users using unblockUsers() with an array of UIDs.

TypeScript
JavaScript

const usersList: String[] = ["UID1", "UID2", "UID3"];

CometChat.unblockUsers(usersList).then(
  (list: Object) => {
      console.log("users list unblocked", { list });
  }, (error: CometChat.CometChatException) => {
      console.log("Unblocking user fails with error", error);
  }
); 

const usersList = ["UID1", "UID2", "UID3"];

CometChat.unblockUsers(usersList).then(
list => {
  console.log("users list unblocked", { list });
}, error => {
  console.log("unblocking user fails with error", error);
}
);

Alternatively, you can use the async/await syntax:

const usersList = ["UID1", "UID2", "UID3"];

try {
  const list = await CometChat.unblockUsers(usersList);
  console.log("users list unblocked", { list });
} catch (error) {
  console.log("unblocking user fails with error", error);
}

Returns an object with UIDs as keys and "success" or "fail" as values. Each User in the request is processed independently.

Get List of Blocked Users

Use BlockedUsersRequestBuilder to fetch blocked users with filtering and pagination.

Set Limit

Sets the number of blocked users to fetch per request.

TypeScript
JavaScript

let limit: number = 30;
let blockedUsersRequest: CometChat.BlockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
  .setLimit(limit)
  .build();

let limit = 30;
let blockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
                  				.setLimit(limit)
                  				.build();

Set Search Keyword

With offline support on, this filter is answered by the server only; the cached page is empty.

Filters blocked users by a search string.

TypeScript
JavaScript

let limit: number = 30;
let searchKeyword: string = "super";
let blockedUsersRequest: CometChat.BlockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
  .setLimit(limit)
  .setSearchKeyword(searchKeyword)
  .build();

let limit = 30;
let searchKeyword = "super";
let blockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
                  				.setLimit(limit)
                  				.setSearchKeyword(searchKeyword)
                  				.build();

Set Direction

Filters by block direction:

BLOCKED_BY_ME — Users blocked by the logged-in user
HAS_BLOCKED_ME — Users who have blocked the logged-in user
BOTH — Both directions (default)

TypeScript
JavaScript

let limit: number = 30;
let blockedUsersRequest: CometChat.BlockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
  .setLimit(limit)
  .setDirection(CometChat.BlockedUsersRequest.directions.BLOCKED_BY_ME)
  .build();

let limit = 30;
let blockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
 .setLimit(limit)
 .setDirection(CometChat.BlockedUsersRequest.directions.BLOCKED_BY_ME)
 .build();

After configuring the builder, call build() to get the BlockedUsersRequest object, then call fetchNext() to retrieve blocked users.

TypeScript
JavaScript

let limit: number = 30;
let blockedUsersRequest: CometChat.BlockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
  .setLimit(limit)
  .build();

blockedUsersRequest.fetchNext().then(
  (userList: CometChat.User[]) => {
      console.log("Blocked user list received:", userList);
  }, (error: CometChat.CometChatException) => {
      console.log("Blocked user list fetching failed with error:", error);
  }
);

const limit = 30;
const blockedUsersRequest = new CometChat.BlockedUsersRequestBuilder()
                  				.setLimit(limit)
                  				.build();
blockedUsersRequest.fetchNext().then(
userList => {
  console.log("Blocked user list received:", userList);
}, error => {
  console.log("Blocked user list fetching failed with error:", error);
}
);

The fetchNext() method returns an array of User objects representing blocked users. Relevant fields to access on returned users:

Field	Getter	Return Type	Description
blockedByMe	`getBlockedByMe()`	`boolean`	Whether the logged-in user has blocked this user
hasBlockedMe	`getHasBlockedMe()`	`boolean`	Whether this user has blocked the logged-in user

Offline Behaviour

With offline support enabled, passing a UserFetchListener to BlockedUsersRequest.fetchNext() calls onCachedUsers first from the SDK’s own blocked-users list. The SDK refreshes that list when the user logs in and after a reconnect sync once the last refresh is more than 12 hours old, and it updates the list when you call blockUsers() or unblockUsers(). Then onServerUsers delivers the live page to reconcile by uid; the server page is not saved to the device. The cached page is empty when no users are blocked or when setSearchKeyword is set. Offline, the read ends with onError (FAILED_TO_FETCH) after the cached page, and the Promise rejects. See Show Cached Data.

Builder method	Offline
`setLimit`	Cached
`setDirection`	Cached. When no direction is set, the cached page lists only the users you blocked.
`setSearchKeyword`	Server only, cached page is empty

Next Steps

Retrieve Users

Fetch and filter user lists

User Presence

Track online/offline status of users

User Management

Create, update, and delete users

Flag Message

Report inappropriate messages from users

​Block Users

​Unblock Users

​Get List of Blocked Users

​Set Limit

​Set Search Keyword

​Set Direction

​Offline Behaviour

​Next Steps

Retrieve Users

User Presence

User Management

Flag Message

Block Users

Unblock Users

Get List of Blocked Users

Set Limit

Set Search Keyword

Set Direction

Offline Behaviour

Next Steps