random-number

Generate pseudo-randum numbers

npm install random-number
2 downloads in the last week
22 downloads in the last month

random-number

generate a (pseudo-)random number

install

npm install random-number

usage

var rn = require('random-number');
rn(); // sample output → 0.704848874360323 # yes, this is just Math.random(), but it has some options

default options

the exported function takes an option object with 3 meaningful properties

  • min : smallest possible value to return. defaults to 0 or max - 1 if max is defined
  • max : largest possible value to return. defaults to 1 or min + 1 if min is defined
  • integer : do you want whole numbers to be returned, or not. defaults to false

Examples

  • all three
// this is the functionality i like the most
var rn = require('random-number');
var options = {
  min:  -1000
, max:  1000
, integer: true
}
rn(options) // example outputs → -187, 636

If you need the same (or almost the same settings many time) you can create a generator instead of passing the options over and over again

var rn = require('random-number');
var gen = rn.generator({
  min:  -1000
, max:  1000
, integer: true
}
gen() // example outputs → -350

What is neat about generators, that you can overwrite any of the settings

generator( min, max, integer) - all arguments are optional:

var rn = require('random-number');
var gen = rn.generator({
  min:  -1000
, max:  1000
, integer: true
}
gen(500) // example outputs → 735
gen(500, null, false) // example outputs → 828.6001032683998
  • only min
var rn = require('random-number');
var options = {
  min: 9874316514 // example input
}
rn(options) // example output → 9874316514.958157
  • only max
var rn = require('random-number');
var options = {
  max: -9874316514 // example input , yes negative values do work
}
rn(options) // example output → -9874316514.075052
  • only integer
var rn = require('random-number');
var options = {
  integer: true
}
// this is basically a true/false random generator, with 50% chance to return true
rn(options) // example output → 1
  • min and max
var rn = require('random-number');
var options = {
  // example input , yes negative values do work
  min:  -10
, max: -1
}
rn(options) // example output → -2.47377512534149
  • min and integer or max and integer
// completely pointless, but whatever
var rn = require('random-number');
var options = {
  min:  1000
, integer: true
}
rn(options) // example output → 1001
options = {
  max:  1000
, integer: true
}
rn(options) // example output → 999
npm loves you