Lists requests to join a group.
Note: This function is only relevant for private groups.
The listJoinRequests()
function returns a Promise that resolves to a list of up to 100 requests to join a group. Sorts by default to _createdDate
in descending order.
Only site admins and group admins can see requests to join their group. Site members can access their own join requests in their site.
Notes:
suppressAuth
option is set to true
, all permissions are overwritten, and all site members (including non-group members) can see requests to join a group.null
as a placeholder for any unspecified parameters. For example, to specify limit
only, call listJoinRequests(groupId, paging, null)
. To specify supressAuth
only, call listJoinRequests(groupId, null, options)
.function listJoinRequests(
groupId: string,
paging: Paging,
options: Options,
): Promise<ListJoinRequests>;
ID of the group requested to join.
Paging options.
Authorization options.
import { Permissions, webMethod } from "wix-web-module";
import { joinRequests } from "wix-groups-backend";
// Sample groupId value:
// 'fc3df3c1-36b2-4279-8be1-8e72a05a88c8'
export const myListJoinRequestsFunction = webMethod(
Permissions.Anyone,
(groupId) => {
return joinRequests
.listJoinRequests(groupId)
.then((joinRequestsResults) => {
const joinRequestStatus = joinRequestsResults.joinRequests[0].status;
return joinRequestsResults;
})
.catch((error) => {
console.error(error);
});
},
);
/* Promise resolves to:
* joinRequests: [
* {
* "memberId": "937cd3db-e9be-4980-93c1-a6d767a11050"
* "_createdDate": "Wed May 14 2021 10:05:20 GMT+0300"
* "status": "REJECTED"
* "rejectionReason": "Wrong group."
* },
* {
* "memberId": "7fe8e9e1-d050-4c86-9684-e7f231600a34"
* "_createdDate": "Sun July 11 2020 03:25:30 GMT+0300"
* "status": "PENDING"
* }
* ],
* metadata:
* {
* "length": 2
* "tooManyToCount": false
* "totalCount": 5
* }
*/
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.