SeedableJS

A simple class based seedable random generator in javascript.

About

The goal is to provide an easy to use seeded random generator comming with set of helpers to quickly generate random numbers, strings, arrays ...

It use a combinaison of the xmur3 hashing function and the mulberry32 pseudo random generator https://stackoverflow.com/questions/521295/seeding-the-random-number-generator-in-javascript/47593316%2347593316

Usage

npm install @llagache/seedablejs

Example :

1import Seedable from "@llagache/seedablejs";
2const s = new Seedable("seed");
3
4var randomValue = s.value();

Constructor :

1/**
2* Create a new Seedable random generator
3* @param {string?} optional seed 
4*/
5new Seedable(seed)

Methods :

1/**
2 * Update seed
3 * @param {string} seed 
4 */
5updateSeed(seed=null)

1/**
2 * @returns random number between 0 & 1
3 */
4value()

1/**
2 * @param {number} min 
3 * @param {number} max 
4 * @returns random number between min & max
5 */
6range(min, max)

1/**
2 * @param {array} array 
3 * @returns random element from an array
4 */
5element(array)

1/**
2 * @param {array} array 
3 * @param {number} min 
4 * @param {number} max 
5 * @param {bool} autorizeDuplicate 
6 * @returns mutiple (between min & max) random elements from an array
7 */
8elements(array, min, max, autorizeDuplicate=true)

1/**
2 * @param {*} sizeX 
3 * @param {*} sizeY 
4 * @returns random image url from piscsum.photos
5 */
6image(sizeX, sizeY)

1/**
2 * @param {number} min 
3 * @param {number} max 
4 * @returns random lorem ipsum sentence
5 */
6lorem(min, max)

1/**
2 * @param {function} factoryFn 
3 * @param {number} length 
4 * @param {bool} unique 
5 * @returns random array of elements based on the factoryFn
6 */
7pool(factoryFn, length, unique = false)

1/**
2 * @param {date} start 
3 * @param {date} end 
4 * @returns random date between start & end
5 */
6date(start, end)

1/**
2 * @param {number} length 
3 * @returns random string using these char [ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789]
4 */
5string(length)

Static Methods :

1/**
2 * @param {number} length 
3 * @returns random seed 
4 */
5Seedable.randomSeed()

Author

Lagache Louis (@llagache_dev)