Benchmark: bignumber.js vs. big.js vs. decimal.js (I) vs currencyjs

HTML Preparation code:

<!--script src="https://raw.githubusercontent.com/iriscouch/bigdecimal.js/v0.6.1/lib/bigdecimal.js"></script-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/bignumber.js/9.0.1/bignumber.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/big.js/6.0.3/big.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/decimal.js/10.2.1/decimal.min.js"></script>
<script src="https://unpkg.com/currency.js/dist/currency.min.js"></script>
<!--script src="https://raw.githubusercontent.com/infusion/Fraction.js/v4.0.12/fraction.min.js"></script-->

Tests:

Native + toFixed
var a = 0.1; var b = 0.2; ((a + b) * b).toFixed(9);
decimal.js
var a = new Decimal("0.1"); var b = new Decimal("0.2"); a.plus(b).times(b).toString();
big.js
var a = new Big("0.1"); var b = new Big("0.2"); a.plus(b).mul(b).toString();
bignumber.js
var a = new BigNumber("0.1"); var b = new BigNumber("0.2"); a.plus(b).multipliedBy(b).toString();
currencyjs
var a = currency('0.1'); var b = currency('0.2'); a.add(b).multiply(b).value

Rendered benchmark preparation results:

Suite status: <idle, ready to run>

Previous results

Test case name	Result
Native + toFixed
decimal.js
big.js
bignumber.js
currencyjs

Fastest: N/A

Slowest: N/A

Autogenerated LLM Summary (model llama3.1:latest, generated one month ago):

LLMs can make mistakes. Check important info.

Let's break down what's being tested and explained in the provided JSON.

**Benchmark Purpose**

The purpose of this benchmark is to compare the performance of different JavaScript libraries for working with decimal numbers: `bignumber.js`, `big.js`, `decimal.js`, and `currencyjs`. These libraries aim to provide efficient and accurate decimal arithmetic, which is essential for various financial, scientific, and mathematical applications.

**Test Cases**

The benchmark consists of five test cases, each using a different library:

1. **Native + toFixed**: This case uses the built-in JavaScript functionality to perform calculations with decimal numbers and then rounds them using the `toFixed()` method.
2. **decimal.js**: This case utilizes the `decimal.js` library to create new Decimal objects from strings, performs calculations on these objects, and returns the result as a string.
3. **big.js**: Similar to the previous case, this test uses the `big.js` library to create new Big objects from strings, performs calculations on them, and returns the result as a string.
4. **bignumber.js**: This test utilizes the `bignumber.js` library in a similar manner, creating new BigNumber objects from strings, performing calculations on them, and returning the result as a string.
5. **currencyjs**: This case uses the `currencyjs` library to create currency objects, performs calculations on these objects, and returns the result as a value.

**Libraries Used**

Here's a brief description of each library:

* `decimal.js`: A popular JavaScript library for decimal arithmetic, providing a robust and efficient way to work with high-precision numbers.
* `big.js`: Another well-known library for working with large integers and decimals, offering a simple and easy-to-use API.
* `bignumber.js`: A library specifically designed for working with very large integers and decimals, providing features like support for various number systems (e.g., base 10, 16, 32).
* `currencyjs`: A library for working with currencies, providing a standardized way to handle currency conversions, formatting, and calculations.

**Key Features**

Some notable features of these libraries include:

* Support for high-precision decimal arithmetic
* Efficient handling of large integers and decimals
* Customizable rounding and formatting options
* Compatibility with various number systems (e.g., base 10, 16, 32)

**Other Alternatives**

While not explicitly mentioned in the benchmark results, other alternatives for working with decimal numbers include:

* Mozilla's `Decimal` class (part of the JavaScript engine)
* Other third-party libraries like `Fraction.js`, which provides support for rational numbers

Keep in mind that these alternatives might have different performance characteristics and feature sets compared to the libraries tested here.

**Recommendation**

Based on the benchmark results, it seems that `bignumber.js` outperforms other libraries in this specific test case. However, the choice of library ultimately depends on your project's requirements, such as precision needs, calculation complexity, and desired performance characteristics.

When selecting a library for working with decimal numbers, consider factors like:

* Performance: Choose a library that balances accuracy with execution speed.
* Precision: Select a library that can handle the required level of precision for your calculations.
* Customizability: Opt for a library that offers flexible rounding and formatting options to suit your needs.
* Compatibility: Consider libraries that support various number systems, if needed.

Remember to evaluate different libraries based on their specific features and performance characteristics, and choose the one that best fits your project's requirements.

Latest run results:

Run details: (Test run date: 15 days ago)

User agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36

Browser/OS: Chrome 130 on Mac OS X 10.15.7

View result in a separate tab

Test name	Executions per second
Native + toFixed	16719049.0 Ops/sec
decimal.js	1667072.4 Ops/sec
big.js	3017316.2 Ops/sec
bignumber.js	1582811.8 Ops/sec
currencyjs	570367.9 Ops/sec

Related benchmarks:

bignumber.js vs. big.js vs. decimal.js (I) vs currencyjs (version: 0)

- https://github.com/MikeMcl/bignumber.js/tree/v9.0.0 - https://github.com/MikeMcl/big.js/tree/v5.2.2 - https://github.com/MikeMcl/decimal.js/tree/v10.2.0

Comparing performance of: Native + toFixed vs decimal.js vs big.js vs bignumber.js vs currencyjs

Created: one year ago by: Guest

Jump to the latest result

Native + toFixed

decimal.js

big.js

bignumber.js

currencyjs

Suite status: <idle, ready to run>

Experimental features:

Fastest: N/A

Slowest: N/A

Autogenerated LLM Summary (model llama3.1:latest, generated one month ago):