discord.js | RoleSelectMenuBuilder

Search...

RoleSelectMenuBuilder

export declare class RoleSelectMenuBuilder extends BaseSelectMenuBuilder<APIRoleSelectComponent>

export declare class RoleSelectMenuBuilder extends BaseSelectMenuBuilder<APIRoleSelectComponent>

A builder that creates API-compatible JSON data for role select menus.

constructor(data?)

Creates a new select menu from API data.

Creating a select menu from an API data object:

const selectMenu = new RoleSelectMenuBuilder({
	custom_id: 'a cool select menu',
	placeholder: 'select an option',
	max_values: 2,
});

const selectMenu = new RoleSelectMenuBuilder({
	custom_id: 'a cool select menu',
	placeholder: 'select an option',
	max_values: 2,
});

Creating a select menu using setters and API data:

const selectMenu = new RoleSelectMenuBuilder({
	custom_id: 'a cool select menu',
})
	.setMinValues(1);

const selectMenu = new RoleSelectMenuBuilder({
	custom_id: 'a cool select menu',
})
	.setMinValues(1);

Name	Type	Optional	Description
data	Partial<APIRoleSelectComponent>	Yes	The API data to create this select menu with

ProtectedReadonly

addDefaultRoles(...roles):this

Adds default roles to this auto populated select menu.

Name	Type	Optional	Description
...roles	RestOrArray<Snowflake>	No	The roles to add

clearPlaceholder():this

Clears the placeholder for this select menu.

setCustomId(customId):this

Sets the custom id for this select menu.

Name	Type	Optional	Description
customId	string	No	The custom id to use

setDefaultRoles(...roles):this

Sets default roles for this auto populated select menu.

Name	Type	Optional	Description
...roles	RestOrArray<Snowflake>	No	The roles to set

setDisabled(disabled?):this

Sets whether this select menu is disabled.

Name	Type	Optional	Description
disabled	boolean	Yes	Whether this select menu is disabled

setMaxValues(maxValues):this

Sets the maximum values that must be selected in the select menu.

Name	Type	Optional	Description
maxValues	number	No	The maximum values that must be selected

setMinValues(minValues):this

Sets the minimum values that must be selected in the select menu.

Name	Type	Optional	Description
minValues	number	No	The minimum values that must be selected

setPlaceholder(placeholder):this

Sets the placeholder for this select menu.

Name	Type	Optional	Description
placeholder	string	No	The placeholder to use

toJSON(validationOverride?):APIRoleSelectComponent

Serializes this builder to API-compatible JSON data.Note that by disabling validation, there is no guarantee that the resulting object will be valid.

Name	Type	Optional	Description
validationOverride	boolean	Yes	Force validation to run/not run regardless of your global preference