GuildMemberManager

.fetch(options?)

options?: { limit?: number; after?: string; } → Promise<GuildMember[]>

Fetch guild members with pagination. GET /guilds/{id}/members.

options?

{ limit?: number; after?: string; }limit (1-1000), after (user ID for pagination)

await guild.members.fetch();

.fetchMe()

→ Promise<GuildMember>

Fetch the current bot user as a GuildMember in this guild. Caches the result in guild.members.

const me = await guild.members.fetchMe();
console.log(me.displayName);

.resolve(userId)

userId: string → Promise<GuildMember>

Get a guild member from cache or fetch from the API if not present. Convenience helper to avoid repeating guild.members.get(userId) ?? (await guild.fetchMember(userId)).

userId

stringSnowflake of the user

const member = await guild.members.resolve(userId);
console.log(member.displayName);

.search(options)

options: GuildMemberSearchOptions → Promise<GuildMemberSearchPayload>

Search guild members. POST /guilds/{id}/members-search.

options

GuildMemberSearchOptionsCamelCase search query, filters, and pagination

const { members } = await guild.members.search({ query: 'alex', limit: 25 });

.set(key, value)

key: string, value: GuildMember → this

Cache a member with optional FIFO eviction when options.cache.members is set.

guild.members.set(key, value);

.sweep(filter?)

filter?: (member: GuildMember, id: string) => boolean → number

Remove members matching a filter (or all if omitted). Returns count removed.

guild.members.sweep();