Utils

This page explains how to work with the internal Utils API. It covers the most important utility functions.

Utils API

To fetch the utility manager, add the following snippet:

const utils = this.heart.core.util.util;

Functions

secureEval(string)

Securely evaluate a string by removing non-numeric characters.

const equation = parseInt(eval(this.heart.core.util.util.secureEval('1 * 2 + 5')));

ms(string)

Convert a time string to milliseconds. The format is 12h 2m 15s 262ms.

const time = this.heart.core.util.util.ms('2m 6s');

ms(number)

Convert milliseconds to a time string.

const time = this.heart.core.util.util.ms(60000);

resolveTime(string)

Resolve a time string to milliseconds. This supports a wide range of formats.

const time = this.heart.core.util.util.resolveTime('1,5h');

sleep(number)

Sleep for a specified amount of time in milliseconds.

await this.heart.core.util.util.sleep(4000);

getRandomElement(array)

Get a random element from an array.

const random = this.heart.core.util.util.getRandomElement([1, 2, 3, 4]);

upperCase(string)

Convert the first letter of a string to uppercase.

const value = this.heart.core.util.util.upperCase('hello');

generateRandom(number, number, array)

Generate a random string.

const id = this.heart.core.util.util.generateRandom(7, 10, ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9']);

isNumber(string)

Check whether a string is a number.

const isNumber = this.heart.core.util.util.isNumber('2165236727247347835835845845');

isEquation(string)

Check whether a string is an equation.

const isEquation = this.heart.core.util.util.isNumber('2 * 326 * 23623 + d + 326 - 23');

validateHex(string)

Validate a hex color code.

const isHex = this.heart.core.util.util.validateHex('#783224');

isPicture(string)

Check whether a file is a picture based on its extension.

const isPicture = this.heart.core.util.util.isPicture(attachment.name);

validateURL(string)

Validate a URL.

const isURL = this.heart.core.util.util.validateURL('https://discord.gg/');