tencent cloud

All product documents
Chat
DocumentationChatNo UI IntegrationUser Profile and Relationship ChainBlocklistJavaScript
JavaScript
Download PDF
Last updated: 2025-01-07 16:18:24
JavaScript
Last updated: 2025-01-07 16:18:24
Download PDF

Feature Overview

To block a user's messages, add the user to the blocklist.
Note:
1. The maximum limit for the blocklist is 1000, and it cannot be adjusted.
2. If you need to add a friend to the blocklist while still maintaining the friendship, go to the Chat console, find the corresponding SDKAppID, navigate to Chat > Configuration > Friends and Relationship > Block configuration, and select Remain Friends.

Blocking a user

By adding a user to the blocklist, you can block all the messages sent by the user. Therefore, this API can be used to block the messages of a specified user.
If user A and user B are friends, the two-way friend relationship is terminated when either A or B is blocked by the other user.
If either user A or user B is blocked by the other user, neither user A nor user B can start a conversation with the other user.
If either user A or user B is blocked by the other user, neither user A nor user B can send a friend request to the other user.
API
chat.addToBlacklist(options);
Parameters
The options parameter is of the Object type. It contains the following attribute values:
Name
Type
Description
userIDList
Array
List of userID values of the users to be added to the blocklist. The number of userID values cannot exceed 1,000 per request.
Return value
Promise
Examples
let promise = chat.addToBlacklist({userIDList: ['user1', 'user2']});
promise.then(function(imResponse) {
  console.log(imResponse.data);
  console.warn('addToBlacklist error:', imError); // Failed to add the user to the blocklist
});

Unblocking a user

After a user is removed from the blocklist, messages from the user can be received.
API
chat.removeFromBlacklist(options);
Parameters
The options parameter is of the Object type. It contains the following attribute values:
Name
Type
Description
userIDList
Array
List of userID values of the users to be removed from the blocklist. The number of userID values cannot exceed 1,000 per request.
Return value
Promise
Examples
let promise = chat.removeFromBlacklist({userIDList: ['user1', 'user2']});
  console.log(imResponse.data);
  console.warn('removeFromBlacklist error:', imError); // Failed to remove the user from the blocklist
});

Getting the blocklist

The blocklist cached in the SDK can be obtained.
API
chat.getBlacklist();
Return value
Promise
Examples
let promise = chat.getBlacklist();
promise.then(function(imResponse) {
  console.log(imResponse.data);
}).catch(function(imError) {
  console.warn('getBlacklist error:', imError); // Failed to obtain the blocklist
});

Notification of a change in the blocklist

When a blocklist is updated, the SDK will deliver the TencentCloudChat.EVENT.BLACKLIST_UPDATED event.
Examples
let onBlacklistUpdated = function(event) {
  console.log(event.data);
};
chat.on(TencentCloudChat.EVENT.BLACKLIST_UPDATED, onBlacklistUpdated);

Previous: Android&iOS&Windows&MacNext: Flutter
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Chat
Hi, I can answer your questions or connect you with a consultant.
Online Support
Connect you with a consultant or answer your questions.
Contact
Contact Us
Contact our sales team or business advisors to help your business.
24/7 Technical Support
Open a ticket if you're looking for further assistance
24/7 Phone Support
Toll Free
Hong Kong, China
+852 800 906 020
United States
+1 844 606 0804
United Kingdom
+44 808 196 4551
Canada
+1 888 605 7930
Australia
+61 1300 986 386
EdgeOne hotlinePaid
+852 300 80699
More local hotlines coming soon