discord.js | UserSelectMenuBuilder

Search...

UserSelectMenuBuilder

export declare class UserSelectMenuBuilder extends BaseSelectMenuBuilder<APIUserSelectComponent>

export declare class UserSelectMenuBuilder extends BaseSelectMenuBuilder<APIUserSelectComponent>

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

constructor(data?)

Creates a new select menu from API data.

Creating a select menu from an API data object:

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

const selectMenu = new UserSelectMenuBuilder({
	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 UserSelectMenuBuilder({
	custom_id: 'a cool select menu',
})
	.setMinValues(1);

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

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

Readonly

data:Partial<SelectMenuType>

The API data associated with this component.

addDefaultUsers(...users):this

Adds default users to this auto populated select menu.

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

setCustomId(customId):this

Sets the custom id for this select menu.

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

setDefaultUsers(...users):this

Sets default users for this auto populated select menu.

Name	Type	Optional	Description
...users	RestOrArray<Snowflake>	No	The users 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

Serializes this builder to API-compatible JSON data.

This method runs validations on the data before serializing it. As such, it may throw an error if the data is invalid.