discord.js | StringSelectMenuBuilder

Search...

StringSelectMenuBuilder

export class StringSelectMenuBuilder extends BuilderStringSelectMenuComponent

export class StringSelectMenuBuilder extends BuilderStringSelectMenuComponent

Class used to build select menu components to be sent through the API

Extends

BuilderStringSelectMenuComponent

constructor(data?)

Constructs a new instance of the StringSelectMenuBuilder class

Name	Type	Optional	Description
data	Partial<StringSelectMenuComponentData \| APIStringSelectComponent>	Yes	None

Readonly

data:Partial<DataType>

The API data associated with this component.

Inherited from ComponentBuilder

Readonly

options:StringSelectMenuOptionBuilder[]

The options within this select menu.

addOptions(...options):this

Adds options to this select menu

Name	Type	Optional	Description
...options	RestOrArray<BuildersSelectMenuOption \| SelectMenuComponentOptionData \| APISelectMenuOption>	No	The options to add to this select menu

Static

from(other):StringSelectMenuBuilder

Creates a new select menu builder from json data

Name	Type	Optional	Description
other	JSONEncodable<APISelectMenuComponent> \| APISelectMenuComponent	No	The other data

setCustomId(customId):this

Sets the custom id for this select menu.

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

Inherited from BaseSelectMenuBuilder

setDisabled(disabled?):this

Sets whether this select menu is disabled.

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

Inherited from BaseSelectMenuBuilder

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

Inherited from BaseSelectMenuBuilder

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

Inherited from BaseSelectMenuBuilder

setOptions(...options):this

Sets the options on this select menu

Name	Type	Optional	Description
...options	RestOrArray<BuildersSelectMenuOption \| SelectMenuComponentOptionData \| APISelectMenuOption>	No	The options to set on this select menu

setPlaceholder(placeholder):this

Sets the placeholder for this select menu.

Name	Type	Optional	Description
placeholder	string	No	The placeholder to use

Inherited from BaseSelectMenuBuilder

spliceOptions(index, deleteCount, ...options):this

Removes, replaces, or inserts options for this select menu.

Remarks

This method behaves similarly to Array.prototype.splice(). It's useful for modifying and adjusting the order of existing options.

Example

Remove the first option:

selectMenu.spliceOptions(0, 1);

selectMenu.spliceOptions(0, 1);

Example

Remove the first n option:

const n = 4;
selectMenu.spliceOptions(0, n);

const n = 4;
selectMenu.spliceOptions(0, n);

Example

Remove the last option:

selectMenu.spliceOptions(-1, 1);

selectMenu.spliceOptions(-1, 1);

Name	Type	Optional	Description
index	number	No	The index to start at
deleteCount	number	No	The number of options to remove
...options	RestOrArray<APISelectMenuOption \| StringSelectMenuOptionBuilder>	No	The replacing option objects or builders

toJSON():APIStringSelectComponent

Serializes this builder to API-compatible JSON data.

Remarks

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