Components & Interactions
getChannelSelectChannelID
$getChannelSelectChannelID
$getChannelSelectChannelID[] returns one selected channel ID of the channel select menu that triggered the current interaction.
Syntax
$getChannelSelectChannelID[index]
Parameters
| Parameter | Description |
|---|---|
index |
Position of the selected channel ID, starting at 1. Required: a positive integer, otherwise Selection index must be a positive integer. |
Return Value
- Type: String
- The selected channel ID at that position.
- An empty string when
indexis greater than the number of selected items.
Behavior
- It raises
Select values require a component callback.outside of a component interaction (interaction type 3), andThis callback has no channelSelect selection.when the interaction that triggered the script is not a channel select menu. - The IDs are those of the channels picked in the menu;
$addCategorySelectand$addVoiceSelectmenus are channel menus too and use these functions. - The number of selected items is returned by
$getChannelSelectChannelCount. - Without brackets (
$getChannelSelectChannelID) the engine refuses the call (Invalid argument count).
Examples
First selection
Selected channel: <#$getChannelSelectChannelID[1]>
Second selection (empty if there is only one)
Second channel: <#$getChannelSelectChannelID[2]>
In an interaction handler
$if[$customID==my_menu]
Selected channel: <#$getChannelSelectChannelID[1]>
$endif
Notes
- The index starts at 1 (0 is an error).
- For all the selections at once, use
$getChannelSelectChannelIDs[separator;(limit)]. - The menu is created with
$addChannelSelect.
Try it
Paste an example into the playground to preview its message (functions that act on Discord are not run), or build the same thing with blocks.