Browse SDKs · uni-app / uni-app x
Platform
SDKsuni-app / uni-app x

Get unhandled group application count

Query the total count of pending group join applications awaiting review.

Copy

Invoke getGroupApplicationUnhandledCount() to retrieve the number of pending group join requests awaiting review, typically used to display badges or notification dots on group administration entry points.

Parameters

The UTS signature requires offset and count parameters:

ParameterTypeRequiredDescription
offsetnumberYesPagination offset; pass 0 for initial counts.
countnumberYesPage limit for evaluating records.

Code example

import {
  getGroupApplicationUnhandledCount,
} from '@/uni_modules/unix-openim-sdk'

const count = await getGroupApplicationUnhandledCount({
  offset: 0,
  count: 20,
})
setPendingApplicationCount(count != null ? count : 0)

Return value

The Promise resolves with a number | null indicating the unhandled count. A null return value indicates that no result could be obtained and should not be treated as a confirmed count of zero.

State changes after the call

This is a read-only query that does not modify records or clear badge indicators. To maintain a real-time badge count, monitor onGroupApplicationBadgeCountChanged as detailed in Get received group applications.