discord.js

class StringSelectMenuBuilder

external
declare class StringSelectMenuBuilder extends BaseSelectMenuBuilder<APIStringSelectComponent>

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

Constructors

constructor(
data?: Partial<APIStringSelectComponent>
)

Creates a new select menu from API data.

Examples:Creating a select menu from an API data object:
const selectMenu = new StringSelectMenuBuilder({
	custom_id: 'a cool select menu',
	placeholder: 'select an option',
	max_values: 2,
	options: [
		{ label: 'option 1', value: '1' },
		{ label: 'option 2', value: '2' },
		{ label: 'option 3', value: '3' },
	],
});
Creating a select menu using setters and API data:
const selectMenu = new StringSelectMenuBuilder({
	custom_id: 'a cool select menu',
})
	.setMinValues(1)
	.addOptions({
		label: 'Catchy',
		value: 'catch',
	});

protectedreadonlyexternal
data : StringSelectMenuData

readonlyexternal
options : readonly StringSelectMenuOptionBuilder[]

The options for this select menu.

external
addOptions(
...options: RestOrArray<APISelectMenuOption | StringSelectMenuOptionBuilder | ((builder: StringSelectMenuOptionBuilder) => StringSelectMenuOptionBuilder)>
) : this

Adds options to this select menu.

external
clearId() : this

Clears the id of this component, defaulting to a default incremented id.

Inherited from: ComponentBuilder

external
clearPlaceholder() : this

Clears the placeholder for this select menu.

Inherited from: BaseSelectMenuBuilder

external
setCustomId(
customId: string
) : this

Sets the custom id for this select menu.

Inherited from: BaseSelectMenuBuilder

external
setDisabled(
disabled?: boolean
) : this

Sets whether this select menu is disabled.

Inherited from: BaseSelectMenuBuilder

external
setId(
id: number
) : this

Sets the id of this component.

Inherited from: ComponentBuilder

external
setMaxValues(
maxValues: number
) : this

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

Inherited from: BaseSelectMenuBuilder

external
setMinValues(
minValues: number
) : this

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

Inherited from: BaseSelectMenuBuilder

external
setOptions(
...options: RestOrArray<APISelectMenuOption | StringSelectMenuOptionBuilder | ((builder: StringSelectMenuOptionBuilder) => StringSelectMenuOptionBuilder)>
) : this

Sets the options for this select menu.

external
setPlaceholder(
placeholder: string
) : this

Sets the placeholder for this select menu.

Inherited from: BaseSelectMenuBuilder

external
spliceOptions(
index: number
deleteCount: number
...options: (APISelectMenuOption | StringSelectMenuOptionBuilder | ((builder: StringSelectMenuOptionBuilder) => StringSelectMenuOptionBuilder))[]
) : this

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

Examples:Remove the first option:
selectMenu.spliceOptions(0, 1);
Remove the first n option:
const n = 4;
selectMenu.spliceOptions(0, n);
Remove the last option:
selectMenu.spliceOptions(-1, 1);

external
toJSON(
validationOverride?: boolean
) : APIStringSelectComponent

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