SDKsWASM

Get joined groups by page

Page through groups joined by the current user.

Use getJoinedGroupListPage() when the user belongs to many groups.

Parameters

Parameter	Type	Required	Description
`offset`	`number`	Yes	Starting offset. Pass `0` for the first page.
`count`	`number`	Yes	Number of groups to read.

const { data: firstPage } = await openimsdk.getJoinedGroupListPage({
  offset: 0,
  count: 50,
});

After the Promise succeeds, data contains the current page of GroupItem[]. Increase offset by the number of items requested, not by a list length that may already have changed after group events arrived.

Group profile fields

Field	Type	Description
`groupID`	`string`	Group ID, used to find the matching group when an event arrives.
`groupName`	`string`	Group name.
`faceURL`	`string`	Group avatar URL.
`introduction`	`string`	Group introduction.
`notification`	`string`	Current group announcement.
`notificationUserID`	`string`	User ID that most recently updated the announcement.
`notificationUpdateTime`	`number`	Time when the announcement was last updated, as a Unix timestamp in milliseconds.
`ownerUserID`	`string`	Current group owner's user ID.
`creatorUserID`	`string`	User ID that created the group.
`createTime`	`number`	Time when the group was created, as a Unix timestamp in milliseconds.
`memberCount`	`number`	Group member count at query time.
`groupType`	`GroupType`	Group type.
`status`	`GroupStatus`	Current group state, such as normal, blocked, dismissed, or group-wide muted.
`needVerification`	`GroupVerificationType`	Policy determining whether joining requires approval.
`applyMemberFriend`	`AllowType`	Whether members may send friend applications to one another.
`lookMemberInfo`	`AllowType`	Whether ordinary members may view other member profiles.
`displayIsRead` Enterprise	`boolean` (optional)	Whether the group displays group-message read state. Browser clients cannot change this field through the group profile API.
`muteBypassUserIDs` Enterprise	`string[]` (optional)	User IDs allowed to send messages while the group is muted.
`ex`	`string`	Application-defined group extension string.
`attachedInfo`	`string` (optional)	SDK attachment data. Parse it only according to a confirmed application contract.

The group name, avatar, and member count reflect the group profile at query time. While the list is open, use groupID to update the matching group when an event arrives. Do not rely only on stale cached data for permission decisions.

If a group-add or group-delete event arrives during pagination, reset pagination and reload from the first page. See Group overview for complete event handling.

Was this page helpful?

Parameters

Return result

Group profile fields