Friend Management

chat.getFriendList();

let promise = chat.getFriendList();
promise.then(function(imResponse) {
  const friendList = imResponse.data; // Contacts
}).catch(function(imError) {
  console.warn('getFriendList error:', imError); // Failed to obtain contacts
});

chat.addFriend(options);

// Add a friend
let promise = chat.addFriend({
  to: 'user1',
  source: 'AddSource_Type_Web',
  remark: 'Jane',
  groupName: 'Friend',
  wording: 'I'm user0',
  type: TencentCloudChat.TYPES.SNS_ADD_TYPE_BOTH,
});
promise.then(function(imResponse) {
  // Sent the friend request successfully
  const { code } = imResponse.data;
  if (code === 30539) {
    // 30539 indicates that user1 has set the friend request processing method
    // to manually accept friend requests received.
    // The SDK will trigger the TencentCloudChat.EVENT.FRIEND_APPLICATION_LIST_UPDATED event.
  } else if (code === 0) {
    // 0 indicates that user1 has set the friend request processing method
    // to automatically accept all friend requests received.
    // The SDK will trigger the TencentCloudChat.EVENT.FRIEND_LIST_UPDATED event.
  }
}).catch(function(imError) {
  console.warn('addFriend error:', imError); // Failed to add the friend
});

chat.deleteFriend(options);

let promise = chat.deleteFriend({
  userIDList: ['user1','user2'],
  type: TencentCloudChat.TYPES.SNS_DELETE_TYPE_BOTH
});
promise.then(function(imResponse) {
  const { successUserIDList, failureUserIDList } = imResponse.data;
  // List of successfully deleted `userID` values
  successUserIDList.forEach((item) => {
    const { userID } = item;
  });
  // List of `userID` values failed to be deleted
  failureUserIDList.forEach((item) => {
    const { userID, code, message } = item;
  });
  // If the contacts are updated,
  // the SDK will trigger the TencentCloudChat.EVENT.FRIEND_LIST_UPDATED event.
}).catch(function(imError) {
  console.warn('removeFromFriendList error:', imError);
});

chat.checkFriend(options);

let promise = chat.checkFriend({
  userIDList: ['user0','user1'],
  type: TencentCloudChat.TYPES.SNS_CHECK_TYPE_BOTH,
});
promise.then(function(imResponse) {
  const { successUserIDList, failureUserIDList } = imResponse.data;
  // List of the `userID` values that passed the verification
  successUserIDList.forEach((item) => {
    const { userID, code, relation } = item; // The value of code is always 0.
    // Possible results of one-way friend verification are:
    // - relation: TencentCloudChat.TYPES.SNS_TYPE_NO_RELATION
    // B is not on A's friend list, but it cannot determine whether A is on B's friend list.
    // - relation: TencentCloudChat.TYPES.SNS_TYPE_A_WITH_B:
    // B is on A's friend list, but it cannot determine whether A is on B's friend list.
    // Possible results of two-way friend verification are:
    // - relation: TencentCloudChat.TYPES.SNS_TYPE_NO_RELATION:
    // A and B are not on each other's friend list
    // - relation: TencentCloudChat.TYPES.SNS_TYPE_A_WITH_B:
    // B is on A's friend list, but A is not on B's friend list
    // - relation: TencentCloudChat.TYPES.SNS_TYPE_B_WITH_A:
    // B is not on A's friend list, but A is on B's friend list
    // - relation: TencentCloudChat.TYPES.SNS_TYPE_BOTH_WAY:
    // A and B are on each other's friend list
  });
  // List of the `userID` values that failed the verification
  failureUserIDList.forEach((item) => {
    const { userID, code, message } = item;
  });
}).catch(function(imError) {
  console.warn('checkFriend error:', imError);
});