JSPM

@chriscodesthings/ultimate-random-number-er

0.2.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
    • 0
  • Score
    100M100P100Q44436F
  • License MIT

Generates random numbers with options for ranges, repetition, past and future sequences ... and more!

Package Exports

  • @chriscodesthings/ultimate-random-number-er
  • @chriscodesthings/ultimate-random-number-er/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@chriscodesthings/ultimate-random-number-er) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ultimate-random-number-er · Test workflow status NPM Version License: MIT

Generates random numbers with options for ranges, repetition, past and future sequences ... and more!

Description

Ultimate Random Numberer provides many extensions to the very basic Math.random() function.

In its basic form it can be called simply with a range and it will return a single random number in that range. It works as a simple function and does not initalize a new object.

In its extended form, it returns a class enabling more advanced features.

Install

npm install --save @chriscodesthings/ultimate-random-number-er

Simple Form

Use

import ultimateRandom from '@chriscodesthings/ultimate-random-number-er';

console.log(ultimateRandom(10));
// => 4

console.log(ultimateRandom(10,20));
// => 17

Syntax

ultimateRandom(n1, n2);

Parameters

  • n1: random number range, or lower limit
  • n2 (optional): random number upper limit

Return Value

Returns a random number. If only n1 is specified, the number is from 0 to n1. If n2 is specified, the number is from n1 to n2.

Ranges are inclusive of the upper and lower limits.

Extended Form

Use

import ultimateRandom from '@chriscodesthings/ultimate-random-number-er';

const random = ultimateRandom(10,20, { options });

console.log(random.number());
// => 12

Options

  • repeat: Default true. If false, the same number won't be returned until the entire range has been used
  • history: Default false. If true, all previous random numbers are stored and can be retreived with the last() method.

Parameters

  • n1: random number range, or lower limit
  • n2 (optional): random number upper limit

Return Value

Returns the Ultimate Random Numberer class.

Methods

number

Description

Gets a random number.

Use

console.log(random.number());
// => 17

Parameters

  • none

Returns

Returns a random number according to the range and options provided when the class was initalized.