Chat JavaScript v4

Chat JavaScript

Chat

JavaScript

Home

Chat

JavaScript

Channel

This is the new Docs for Chat SDK v4 for JavaScript. To see the previous Docs, click here.

Search group channels by name, URL, or several types of filters

You can search for specific private or public group channels by using several types of search filters within GroupChannelListQuery and PublicGroupChannelListQuery classes.

Search public group channels

A PublicGroupChannelListQuery instance provides several types of search filters such as ChannelNameContainsFilter and ChannelUrlsFilter. You can use these filters to search for specific public group channels.

The sample code below shows the query instance, which returns a list of the current user's group channels that partially match the specified keyword in ChannelNameContainsFilter in the channels' name.

const params: PublicGroupChannelListQueryParams = {
  includeEmpty: true,
  channelNameContainsFilter: 'Sendbird',
};
const query: PublicGroupChannelListQuery = sb.groupChannel.createPublicGroupChannelListQuery(params);

const channels: GroupChannel[] = await query.next();

The following shows the query instance, which returns a list of the current user's group channels that partially match the keyword specified in ChannelUrlsFilter in the channel URLs.

const params: PublicGroupChannelListQueryParams = {
  includeEmpty: true,
  channelUrlsFilter: ['seminar', 'lecture'],
};
const query: PublicGroupChannelListQuery = sb.groupChannel.createPublicGroupChannelListQuery(params);

const channels: GroupChannel[] = await query.next();

The following table shows all supported parameters that can be used as filters for PublicGroupChannelListQuery to search for specific channels you want to retrieve. You can use any of the parameters with the sample code above.

List of parameters

Parameter name	Type	Description
CustomTypesFilter	string	Specifies group channels with one or more specified custom types you want to retrieve.
CustomTypeStartsWithFilter	string	Specifies group channels with a custom type that starts with the specified value you want to retrieve.
ChannelNameContainsFilter	string	Specifies group channels that contain the specified value in their names you want to retrieve.
ChannelUrlsFilter	string	Specifies group channels with one or more specified channel URLs you want to retrieve.
SuperChannelFilter	enum	Specifies either super group channels or group channels you want to retrieve. Acceptable values are `all`, `broadcast_only`, `exclusive_only`, `nonsuper`, and `super`.
MembershipFilter	enum	Specifies group channels with specified membership you want to retrieve. Acceptable values are `ALL` and `JOINED`.
MetaDataOrderKeyFilter	string	Specifies group channels with metadata containing an item with the specified value as its key. This filter is effective only when the metadata are sorted in alphabetical order you want to retrieve.

Search private group channels

A GroupChannelListQuery instance provides several types of search filters such as ChannelNameContainsFilter and ChannelUrlsFilter. You can use these filters to search for specific private group channels.

const params: GroupChannelListQueryParams = {
  includeEmpty: true,
  channelNameContainsFilter: 'Sendbird',
};
const query: GroupChannelListQuery = sb.groupChannel.createMyGroupChannelListQuery(params);

const channels: GroupChannel[] = await query.next();

The following shows the query instance, which returns a list of the current user's group channels that partially match the specified keyword in the ChannelUrlsFilter in the channels' URL.

const params: GroupChannelListQueryParams = {
  includeEmpty: true,
  channelUrlsFilter: ['seminar', 'lecture'],
};
const query: GroupChannelListQuery = sb.groupChannel.createMyGroupChannelListQuery(params);

const channels: GroupChannel[] = await query.next();

The following table shows all supported parameters that can be used as filters for GroupChannelListQuery to search for specific channels you want to retrieve. You can use any of the parameters with the sample code above.

List of parameters

Parameter name	Type	Description
CustomTypesFilter	string	Specifies group channels with one or more specified custom types you want to retrieve.
CustomTypeStartsWithFilter	string	Specifies group channels with a custom type that starts with the specified value you want to retrieve.
ChannelNameContainsFilter	string	Specifies group channels that contain the specified value in their names you want to retrieve.
ChannelUrlsFilter	string	Specifies group channels with one or more specified channel URLs you want to retrieve.
SuperChannelFilter	enum	Specifies either super group channels or group channels you want to retrieve. Acceptable values are `all`, `broadcast_only`, `exclusive_only`, `nonsuper`, and `super`.
PublicChannelFilter	enum	Specifies either public or private group channels you want to retrieve. Acceptable values are `all`, `private`, and `public`.
UnreadChannelFilter	enum	Specifies group channels with one or more unread messages you want to retrieve. Acceptable values are `all` and `unread_message`.
HiddenChannelFilter	enum	Specifies group channels with the specified state and operating behavior you want to retrieve. Acceptable values are `hidden_only`, `hidden_allow_auto_unhide`, `hidden_prevent_auto_unhide`, and `unhidden_only`.
MyMemberStateFilter	enum	Specifies group channels' invitation status such as invitation accept status and invitation sent status you want to retrieve. Acceptable values are `all`, `invited_only`, `invited_by_friend`, `invited_by_non_friend`, and `joined_only`.
NicknameContainsFilter	string	Specifies group channels with members whose nicknames contain the specified value you want to retrieve.
MetaDataOrderKeyFilter	string	Specifies group channels with metadata containing an item with the specified value as its key. This filter is effective only when the metadata are sorted in alphabetical order you want to retrieve.

Retrieve a list of Supergroup channels using a filter

You can retrieve a list of Supergroup channels through the GroupChannelListQuery's superChannelFilter property. A Supergroup channel is determined by the isSuper property. If the property has a value of true, the channel is a Supergroup channel.

const params: GroupChannelListQueryParams = {
  superChannelFilter: SuperChannelFilter.SUPER,
};
const query: GroupChannelListQuery = sb.groupChannel.createMyGroupChannelListQuery(params);

const channels: GroupChannel[] = await query.next();

Sample app