Calculator
Evaluate arithmetic expressions with arbitrary-precision decimal math using big.js.
When to Use
- User asks to calculate or evaluate a math expression
- Precise decimal arithmetic is needed (avoids floating-point errors like
0.1 + 0.2 = 0.30000000000000004)
- Expressions involve parentheses, operator precedence, or exponents
Supported Operations
| Operator |
Description |
Precedence |
+ |
Addition |
1 |
- |
Subtraction |
1 |
* |
Multiplication |
2 |
/ |
Division |
2 |
^ |
Exponent (right-associative) |
3 |
() |
Parentheses |
Highest |
Usage
cd scripts
npm ci || npm install
npm run build
npm run calculate "<expression>"
Examples
| Input |
Output |
"3 + 2" |
5 |
"10 / 4" |
2.5 |
"2 ^ 10" |
1024 |
"(2 + 3) * 4" |
20 |
"1 + 4.5 * (3-6) / 5" |
-1.7 |
"-5 + 3" |
-2 |
"2 ^ 3 ^ 2" |
512 (right-associative: 2^9) |
Edge Cases
-
Empty expression: Throws "Empty expression" error
-
Mismatched parentheses: Throws "Mismatched parentheses" error
-
Division by zero: big.js throws an error
-
Exponent must be integer: big.js
.pow() requires integer exponents
Limitations
- No trigonometric functions (sin, cos, tan)
- No variables or symbolic math
- Exponents must be integers
- No factorial, modulo, or bitwise operators
