randomcryp

A cryptographically secure, feature rich, zero dependency, lightweight and browser friendly random number generator library. Only ~5KB in size. Uses Crypto.getRandomValues() to get its randomness. The spelling is random-creep in case you are wondering.

Featues

• Lightweight
• Browser friendly
• TypeScript definitions
• Lots of methods and common aliases
• Batteries Included (Zero dependencies)
• Supported in all major JavaScript / TypeScript runtimes (Browser, Node, Deno, Bun etc.)

Install

bun add randomcryp # bun
yarn add randomcryp # yarn
pnpm add randomcryp # pnpm
npm install randomcryp # npm

Usage

import random from "randomcryp";

float(); // 0.190088246732104

Or,

import { rangeInt } from "randomcryp";

rangeInt(1, 10); // 7

List of Methods

Method	Description	Aliases
bool(): boolean	Generates a random boolean (true or false).	bool() → true
boolean(): boolean	Alias for bool().	boolean() → false
percentage(p: number): boolean	Generates true at given percentage of time.	percentage(20) → false
probability(p: number): boolean	Generates true with a given probability p and false with probability 1-p.	probability(0.8) → true
uSafeInt(): number	Generates a random integer between 0 (inclusive) and Number.MAX_SAFE_INTEGER (inclusive).	uSafeInt() → 4946544243668033
float(): number	Generates a random number between 0 (inclusive) and 1 (exclusive).	number() → 0.190088246732104
random(): number	Alias for float().	random() → 0.9520779718919631
hex(length: number = 8, prefix: boolean = false): string	Generates a random hex string of the specified length (default 8). Optionally prefixes with '0x'.	hex(16) → d1ef0149c7849844
choice(arr: ArrayLike<E>): E	Selects a random element from an array.	choice([1, 2, 3, 4, 5]) → 3
pick(arr: ArrayLike<E>): E	Alias for choice().	pick([1, 2, 3, 4, 5]) → 1
shuffle(input: string): string, shuffle(input: Array<E>): Array<E>	Returns a new array or string after shuffling the given array or string randomly.	shuffle([1, 2, 3, 4, 5]) → [ 1, 3, 2, 5, 4 ]
range(min: number, max: number): number	Generates a random number (not integer) between given min (inclusive) and max (exclusive). Throws if min > max.	range(1, 5) → 4.103370176158448
rangeInt(min: number, max: number): number	Generates a random number (not integer) between given min (inclusive) and max (exclusive). Throws if min > max.	rangeInt(1, 10) → 8
randInt(min: number, max: number): number	Alias for rangeInt().	randInt(1, 100) → 35
safeInt(): number	Generates a random integer between Number.MIN_SAFE_INTEGER (inclusive) and Number.MAX_SAFE_INTEGER (inclusive). +0 and -0 both can be generated. 54 bits precision. Not recommended for general usage.	safeInt() → -5802548511349229
ifloat(): number	Generates a random number between -1 (inclusive) and 1 (inclusive). Uses safeInt() and thus not recommended.	ifloat() → -0.6076475248861822

© 2025, Md. Touhidur Rahman. License: BSD-3-Clause.