better-math

Mathematical operations performed reliably and intuitively

Why?

• No ugly approximation:

    0.1 + 0.2 // => 0.30000000000000004
    math.add(0.1, 0.2) // => 0.3

• No messy unpredictable type conversion:

    1 + '1' // => '11'
    true - 1 // => 0
    [] + 1.1 // => '1.1'
    [] - 1.1 // => '-1.1'
    {} + 1.1 // => 1.1
 
    math.add(1, '1') // => Uncaught Error: Both arguments must be finite numbers
    math.add(true, -1) // => Uncaught Error: Both arguments must be finite numbers
    math.add([], 1.1) // => Uncaught Error: Both arguments must be finite numbers
    math.add([], 1.1) // => Uncaught Error: Both arguments must be finite numbers
    math.add({}, 1.1) // => Uncaught Error: Both arguments must be finite numbers

Install

$ npm install --save better-math

Usage

var math = require('better-math')
 
math.add(0.1, 0.2) // => 0.3
math.add(0.1, -0.2) // => -0.1

API

math.add (number1, number2)

number1, number2

Type: real number for both arguments strictly enforced with no exceptions!

No Infinities, no NaNs, no null, no strings (not even '1'!):

  if (!isFinite(x) || !isFinite(y)) throw Error('Both arguments must be finite numbers')

Status

Currently .add is implemented and thoroughly tested

Credit

• This library is a tiny wrapper around the wonderful arbitrary-precision decimal arithmetic library Big.js that deserves most credit
• The (also wonderful)) LoDash is used for type checking

License

MIT © Dmitri Zaitsev