es-number-ext v1.0.0

es-number-ext

Native number extensions for javascript and typescript.

!IMPORTANT This library extend the native objects Number.prototype. This may lead to collision with other libraries or the latest version of ECMAScript.

Table of Contents

1. Installation
2. Usage
3. Functions
4. Advanced Usage
5. Test
6. License

Installation

Under your project folder, run the follow command in the terminal.

npm i --save es-number-ext

Usage

Prototype Version

// For Number prototype
// Import at the entry point of the project, such as index.ts
import from "es-number-ext"

const number = Number.random(5,10);

Clean Version - (Non prototype pollution)

// For non-pollution
// Import at the .ts file where you are going to use
import { random, ... } from "es-number-ext/clean"

const number = random(5,10);

Functions

Generates a random integer within a specified range.

$${\color{gray}Parameters}$$

$${\color{gray}Return}$$

$${\color{gray}Example}$$

Number.random(3)   // might return 2 (0 ~ 2)
Number.random(-3)  // might return -2 (-3 ~ -1)

${\color{gray}Parameters}$

${\color{gray}Return}$

${\color{gray}Example}$

Number.random(1, 5)    // might return 4 (1 ~ 4) 
Number.random(-5, -1)  // might return -2 (-5 ~ -2)

Generates a random number based on mean and sd (normal distribution).

${\color{gray}Parameters}$

${\color{gray}Return}$

${\color{gray}Example}$

Number.randomND(3, 1)     // might return 3.5 
Number.randomND(3.2, 0)   // might return 3.2

Advanced Usage

Clean Import - (Non prototype pollution)

// For non-pollution
import { random, ... } from "es-number-ext/clean"

const number = random(5,10);

Specifc Function - (To avoid collision with other libraries)

import "es-number-ext/random"
import "es-number-ext/randomND"

const number = Number.random(5,10);
const numberND = Number.randomND(3,2);

Test

npm run test

License

• MIT License