Skip to main content

Utility Functions

Yukino provides several helpful utility functions for common tasks. These are especially useful when building bots or handling audio/queue logic.

Check URL​

isValidURL(url: string): boolean Checks if a string is a valid URL.

import { isValidURL } from 'yukinojs';

isValidURL('https://example.com'); // true
isValidURL('not a url'); // false

Format Time​

formatTime(ms: number): string Formats milliseconds into a human-readable time string (hh:mm:ss or mm:ss).

import { formatTime } from 'yukinojs';

formatTime(65000); // '01:05'
formatTime(3723000); // '01:02:03'

Wait​

wait(ms: number): Promise<void> Returns a Promise that resolves after the specified milliseconds.

import { wait } from 'yukinojs';

await wait(1000); // Waits 1 second

Merge Default Options​

mergeDefault<T>(def: T, given: Partial<T>): T Deep merges a default object with user-provided options.

import { mergeDefault } from 'yukinojs';

const defaults = { volume: 100, filters: { bass: false } };
const user = { filters: { bass: true } };
const merged = mergeDefault(defaults, user);
// merged: { volume: 100, filters: { bass: true } }

Generate Random String​

generateRandomString(length: number): string Generates a random alphanumeric string of the given length.

import { generateRandomString } from 'yukinojs';

generateRandomString(8); // e.g. 'aB3dE9fG'

These utilities are available throughout Yukino and can simplify many common coding tasks.