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.