JavaScript does some very crazy things with rounding.
TL,DR; Use the default method to round sanely and get back a 2decimal place string.
Most of us were taught in school to use the 'round half up' method, like so:
Round 3.14159 to 1 decimal place
=> 3.1
Round 3.14159 to 2 decimal places
=> 3.14
Round 3.14159 to 3 decimal places
=> 3.142
Round 3.14159 to 4 decimal places
=> 3.1416
If you are rounding to 'x' places, and the digit in the 'x+1' position is equal to or greater than 5, round the 'xth' digit up. Otherwise just drop the extra decimal places.
This module helps you do just that. It also provides more granular methods if you prefer a different rounding strategy.
npm install simpleround
simpleround
can return your rounded number as either a number
or string
, depending on which method you pick.
The default method both rounds halfup to 2 decimal places and returns the result as a string, formatted to 2 decimal places. This is different than using JavaScript's Number.toFixed()
method, which sometimes rounds up and sometimes rounds down (?), or Math.round()
, which does things you might not expect, including returning your result in scientific notation, because...?
The {braces}
are required in the require
:
const {fixedSimpleRound} = require('simpleround');
expect(fixedSimpleRound(3.14159)).toEqual('3.14');
Need more control? Yes, the {braces}
are required, in both the require
and the method call:
Params:

precision
(nonnegative) 
number

direction
(from the set below)
const {fixedRound, DIRECTIONS} = require('simpleround');
let number = 0.9999;
let direction = DIRECTIONS.DOWN;
let precision = 3;
expect(fixedRound({number, direction, precision})).toEqual('0.999');
let direction = DIRECTIONS.UP;
expect(fixedRound({number, direction, precision})).toEqual("1.000");
Default behavior for fixedRound
is rounding halfup, to 2 decimal places. Omit either or both of those arguments if that's OK with you.
These two methods return your result as a number. The rounding will be correct, but leading or trailing zeros might be dropped.
Supply the number
argument. Rounds HALF_UP to 2 decimal places:
const {simpleRound} = require('simpleround');
expect(simpleRound(3.14159)).toEqual(3.14);
expect(simpleRound(2.345)).toEqual(2.35);
expect(simpleRound(0.999)).toEqual(1.00);
expect(simpleRound(0.285)).toEqual(0.29);
Params as above. Yes, the {braces}
are required, in both the require
and the method call:
const {round, DIRECTIONS} = require('simpleround');
/*
DIRECTIONS.UP
DIRECTIONS.DOWN
DIRECTIONS.HALF_UP
DIRECTIONS.HALF_DOWN
*/
let number = 3.14159;
let direction = DIRECTIONS.DOWN;
let precision = 3;
expect(round({number, direction, precision})).toEqual(3.141);
let direction = DIRECTIONS.UP;
expect(round({number, direction, precision})).toEqual(3.142);
let direction = DIRECTIONS.HALF_UP;
expect(round({number, direction, precision})).toEqual(3.142);
let direction = DIRECTIONS.HALF_DOWN;
expect(round({number, direction, precision})).toEqual(3.141);
Default behavior for round()
is to round HALF_UP to 2 decimal places. Omit either or both of those arguments if that's OK with you.
npm run test