Carbon
Core/Classes

OptionsHandler

This class is used to parse the options of a command, and provide errors for any missing or invalid options. It is used internally by the Command class.

Extends

  • Base

Extended by

Constructors

Constructor

new OptionsHandler(client, options): OptionsHandler

Parameters

ParameterType
clientClient
optionsAPIApplicationCommandInteractionDataOption[]

Returns

OptionsHandler

Overrides

Base.constructor

Properties

PropertyModifierTypeDescriptionInherited from
clientpublicClient-Base.client
rawreadonlyAPIApplicationCommandInteractionDataBasicOption[]The raw options that were in the interaction data, before they were parsed.-

Methods

getBoolean()

Call Signature

getBoolean(key, required?): undefined | boolean

Get the value of a boolean option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
required?falseWhether the option is required.
Returns

undefined | boolean

The value of the option, or undefined if the option was not provided and it is not required.

Call Signature

getBoolean(key, required): boolean

Get the value of a boolean option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
requiredtrueWhether the option is required.
Returns

boolean

The value of the option, or undefined if the option was not provided and it is not required.


getChannel()

Call Signature

getChannel(key, required?): Promise<undefined | null | DmChannel<false> | GroupDmChannel<false> | GuildTextChannel<false> | GuildVoiceChannel<false> | GuildCategoryChannel<false> | GuildAnnouncementChannel<false> | GuildThreadChannel<ThreadChannelType, false> | GuildStageChannel<false> | GuildForumChannel<false> | GuildMediaChannel>

Get the value of a channel option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
required?falseWhether the option is required.
Returns

Promise<undefined | null | DmChannel<false> | GroupDmChannel<false> | GuildTextChannel<false> | GuildVoiceChannel<false> | GuildCategoryChannel<false> | GuildAnnouncementChannel<false> | GuildThreadChannel<ThreadChannelType, false> | GuildStageChannel<false> | GuildForumChannel<false> | GuildMediaChannel>

The value of the option, or undefined if the option was not provided and it is not required.

Call Signature

getChannel(key, required): Promise<null | DmChannel<false> | GroupDmChannel<false> | GuildTextChannel<false> | GuildVoiceChannel<false> | GuildCategoryChannel<false> | GuildAnnouncementChannel<false> | GuildThreadChannel<ThreadChannelType, false> | GuildStageChannel<false> | GuildForumChannel<false> | GuildMediaChannel>

Get the value of a channel option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
requiredtrueWhether the option is required.
Returns

Promise<null | DmChannel<false> | GroupDmChannel<false> | GuildTextChannel<false> | GuildVoiceChannel<false> | GuildCategoryChannel<false> | GuildAnnouncementChannel<false> | GuildThreadChannel<ThreadChannelType, false> | GuildStageChannel<false> | GuildForumChannel<false> | GuildMediaChannel>

The value of the option, or undefined if the option was not provided and it is not required.


getInteger()

Call Signature

getInteger(key, required?): undefined | number

Get the value of an integer option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
required?falseWhether the option is required.
Returns

undefined | number

The value of the option, or undefined if the option was not provided and it is not required.

Call Signature

getInteger(key, required): number

Get the value of an integer option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
requiredtrueWhether the option is required.
Returns

number

The value of the option, or undefined if the option was not provided and it is not required.


getMentionable()

Call Signature

getMentionable(key, required?): Promise<undefined | User<false> | Role<true>>

Get the value of a mentionable option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
required?falseWhether the option is required.
Returns

Promise<undefined | User<false> | Role<true>>

The value of the option, or undefined if the option was not provided and it is not required.

Call Signature

getMentionable(key, required): Promise<User<false> | Role<true>>

Get the value of a mentionable option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
requiredtrueWhether the option is required.
Returns

Promise<User<false> | Role<true>>

The value of the option, or undefined if the option was not provided and it is not required.


getNumber()

Call Signature

getNumber(key, required?): undefined | number

Get the value of a number option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
required?falseWhether the option is required.
Returns

undefined | number

The value of the option, or undefined if the option was not provided and it is not required.

Call Signature

getNumber(key, required): number

Get the value of a number option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
requiredtrueWhether the option is required.
Returns

number

The value of the option, or undefined if the option was not provided and it is not required.


getRole()

Call Signature

getRole(key, required?): undefined | Role<true>

Get the value of a role option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
required?falseWhether the option is required.
Returns

undefined | Role<true>

The value of the option, or undefined if the option was not provided and it is not required.

Call Signature

getRole(key, required): Role<true>

Get the value of a role option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
requiredtrueWhether the option is required.
Returns

Role<true>

The value of the option, or undefined if the option was not provided and it is not required.


getString()

Call Signature

getString(key, required?): undefined | string

Get the value of a string option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
required?falseWhether the option is required.
Returns

undefined | string

The value of the option, or undefined if the option was not provided and it is not required.

Call Signature

getString(key, required): string

Get the value of a string option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
requiredtrueWhether the option is required.
Returns

string

The value of the option, or undefined if the option was not provided and it is not required.


getUser()

Call Signature

getUser(key, required?): undefined | User<true>

Get the value of a user option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
required?falseWhether the option is required.
Returns

undefined | User<true>

The value of the option, or undefined if the option was not provided and it is not required.

Call Signature

getUser(key, required): User<true>

Get the value of a user option.

Parameters
ParameterTypeDescription
keystringThe name of the option to get the value of.
requiredtrueWhether the option is required.
Returns

User<true>

The value of the option, or undefined if the option was not provided and it is not required.

On this page