Eval

Advanced eval command for bot owner tests.

Description

This command is surely the most useful of all, after the help command of course. It is used to execute JavaScript critical code directly on the server where the bot is located. This can be used in particular to test features or to do debugging.

The package used by this command to resolve the code is on npm as discord-eval.ts, which itself uses ghom-eval. These two packages are created by the creator of this framework.

Command pattern

In the Discord server where you invited the bot, use the following command pattern in a channel accessible by the bot.

.eval <code> [--muted: <boolean>] [--use: <Array<string>>]

For example:

.eval
return 42 + "0"

Automatic return

If you type your entire command on one line, you can ignore the keyword return. It will be added automatically.

.eval 42 + "0"

Code blocks

You also have the possibility to encode your code between markdown tags in order to have the indentation.

.eval ```js
return 42 + "0"
```

Async / Await

If your code contains async/await, it works at top level like on Deno!

.eval await fetch("https://api.mathjs.org/v4/?expr=42+0")

Arguments

Check the Command/Arguments section if you have a problem.

--use

You can install and use NPM packages in your eval with the --use argument. You can then use the imported packages via the req object. the NPM packages are removed after the command.

.eval --use prettier,esbuild,make-bot.ts
req.prettier // ok
req["make-bot.ts"] // ok
return 42 + "0"

--muted

If you want to run your code in silence, use the --muted flag (or just -m).

.eval --muted
return 42 + "0"

Annexes

• Command file

• discord-eval.ts