Skip to main content

Class: InteractionHandler<O>

The piece to be stored in Store instances.

Type parameters

NameType
Oextends Options = Options

Hierarchy

  • Piece<O>

    InteractionHandler

Constructors

constructor

new InteractionHandler<O>(context, options)

Type parameters

NameType
Oextends InteractionHandlerOptions<O> = InteractionHandlerOptions

Parameters

NameType
contextPieceContext
optionsInteractionHandlerOptions

Overrides

Piece.constructor

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:19

Properties

enabled

enabled: boolean

Whether or not the piece is enabled.

Inherited from

Piece.enabled

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:450


interactionHandlerType

Readonly interactionHandlerType: InteractionHandlerTypes

The type for this handler

Since

3.0.0

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:17


location

Readonly location: PieceLocation

The location metadata for the piece's file.

Inherited from

Piece.location

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:442


name

Readonly name: string

The name of the piece.

Inherited from

Piece.name

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:446


options

Readonly options: O

The raw options passed to this Piece

Inherited from

Piece.options

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:454


store

store: InteractionHandlerStore

The InteractionHandlerStore that contains this InteractionHandler.

Overrides

Piece.store

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:11

Accessors

container

get container(): Container

A reference to the Container object for ease of use.

See

container

Returns

Container

Inherited from

Piece.container

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:460

Methods

none

none(): None

Returns

None

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:80


onLoad

onLoad(): unknown

Per-piece listener that is called when the piece is loaded into the store. Useful to set-up asynchronous initialization tasks.

Returns

unknown

Inherited from

Piece.onLoad

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:465


onUnload

onUnload(): unknown

Per-piece listener that is called when the piece is unloaded from the store. Useful to set-up clean-up tasks.

Returns

unknown

Inherited from

Piece.onUnload

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:470


parse

parse(_interaction): Awaitable<Option<unknown>>

A custom function that will be called when checking if an interaction should be passed to this handler. You can use this method to not only filter by ids, but also pre-parse the data from the id for use in the run method.

By default, all interactions of the type you specified will run in a handler. You should override this method to change that behavior.

Example

// Parsing a button handler
public override parse(interaction: ButtonInteraction) {
if (interaction.customId.startsWith('my-awesome-clicky-button')) {
// Returning a `some` here means that the run method should be called next!
return this.some({ isMyBotAwesome: true, awesomenessLevel: 9001 });
}

// Returning a `none` means this interaction shouldn't run in this handler
return this.none();
}

Example

// Getting data from a database based on the custom id
public override async parse(interaction: ButtonInteraction) {
// This code is purely for demonstration purposes only!
if (interaction.customId.startsWith('example-data')) {
const [, userId, channelId] = interaction.customId.split('.');

const dataFromDatabase = await container.prisma.exampleData.findFirst({ where: { userId, channelId } });

// Returning a `some` here means that the run method should be called next!
return this.some(dataFromDatabase);
}

// Returning a `none` means this interaction shouldn't run in this handler
return this.none();
}

Parameters

NameType
_interactionInteraction

Returns

Awaitable<Option<unknown>>

An Option (or a Promise Promised Option) that indicates if this interaction should be handled by this handler, and any extra data that should be passed to the run method

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:70


reload

reload(): Promise<void>

Reloads the piece by loading the same path in the store.

Returns

Promise<void>

Inherited from

Piece.reload

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:478


run

Abstract run(interaction, parsedData?): unknown

Parameters

NameType
interactionInteraction
parsedData?unknown

Returns

unknown

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:25


some

some(): Some<never>

Returns

Some<never>

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:74

some<T>(data): Some<T>

Type parameters

Name
T

Parameters

NameType
dataT

Returns

Some<T>

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:75


toJSON

toJSON(): InteractionHandlerJSON

Defines the JSON.stringify behavior of this piece.

Returns

InteractionHandlerJSON

Overrides

Piece.toJSON

Defined in

projects/framework/src/lib/structures/InteractionHandler.ts:84


unload

unload(): Promise<void>

Unloads and disables the piece.

Returns

Promise<void>

Inherited from

Piece.unload

Defined in

node_modules/@sapphire/pieces/dist/index.d.ts:474