Classhttpv0.1.0

AutocompleteHandler

Base class for an autocomplete handler on the HTTP transport.

Pass the command route(s) from the generated registry as the generic. Branch on the focused field with this.match, read already-entered sibling options with this.options, and find which command fired with this.route.

abstract class AutocompleteHandler<
    Route extends keyof SlashOptionRegistry
> extends BaseHandler<APIApplicationCommandAutocompleteInteraction, Core>

Member visibility

Filter class members by access level.

constructor

Constructs a new instance of the AutocompleteHandler class

AutocompleteHandler(
    event: APIApplicationCommandAutocompleteInteraction,
    core: Core,
    dispatch?: DispatchContext
)

Showing members with Protected visibility and higher.

Methods

match()
respond()

Route

One or more route keys from SlashOptionRegistry, e.g. 'search'.

Route extends keyof SlashOptionRegistry

api

Typed Discord REST API (@discordjs/core/http-only) over core.rest, one instance per core.

protected api: API

focused

The focused option for this interaction. value is always the raw partial string the user is typing, even for an integer or number option, so coerce it yourself when you need a number.

protected focused: FocusedField<Route>

options

The already-entered options on this command, restricted to the kinds Discord resolves during autocomplete (string, integer, number, boolean) with every read nullable, since a sibling is partial while the user types the focused field. The focused field is on this.focused.

protected options: AutocompleteOptions<Route>

route

The firing command route, for a field whose completion differs per registered command.

protected route: Route

match()

Run the arm for the focused field. An autocomplete always dispatches by which field is focused, so match is how you read it.

Provide one arm per autocompletable field across the registered commands, keyed by field name. Each arm receives the focused partial value and a respond typed to that field's choice value. The arms must cover every autocompletable field, a missing field or an unknown key is a compile error. A focused field with no arm, only reachable from a stale-deployed command, throws at runtime.

protected async match<Ret>(
    arms: FocusedArms<Route, Ret>
): Promise<Ret>

Parameter: arms

One handler per autocompletable field, keyed by field name.

respond()

Send autocomplete suggestions, callback type 8. Prefer match, which restricts each field's choices to its declared type.

protected async respond(
    choices: readonly APIApplicationCommandOptionChoice[]
): Promise<void>