Member Search

Search guild members with guild.members.search and camelCase filters.

When you need members by name or role without iterating the whole cache, use the search helper on the guild member manager.

Basic query

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

for (const hit of result.members) {
  console.log(hit.username, hit.userId, hit.member?.displayName);
}

Filter by roles

javascript
const result = await guild.members.search({
  roleIds: [modRoleId],
  limit: 50,
});
console.log(result.total, result.hasMore);

Option names are camelCase (roleIds, query, limit). Check the SDK reference for the full option set if you need more filters.

Resolve one member

For a known user ID, prefer cache then fetch:

javascript
const member =
  guild.members.get(userId) ?? (await guild.fetchMember(userId));

Or guild.members.resolve(userId) when that helper is available on your build.

Permissions, Roles, Caching.