JavaScript Other
Latest commit f81f6f3 Jul 14, 2018
Failed to load latest commit information.
benchmark Add benchmark to test numeric matrices vs generic matrices Jul 8, 2018
bin Woohoo fixed the last lint errors Jun 13, 2018
browser-test-config Refactored `var` into `const`/`let`, and removed a lot of semicolons Jun 13, 2018
docs Released `v5.0.3` Jul 14, 2018
examples Fixed advanced example `add_new_datatypes`, upgraded dependencies Jul 4, 2018
img Updated favicon Jan 5, 2016
misc Released v5.0.0 Jun 16, 2018
src Released `v5.0.3` Jul 14, 2018
test-dist Released v5.0.0 Jun 16, 2018
test-node/function Consistend camel case naming of variables and functions Jun 13, 2018
test Fixed lint problems Jul 11, 2018
tools Woohoo fixed the last lint errors Jun 13, 2018
.babelrc Setup Babel compilation (WIP) Jun 6, 2018
.gitignore Revert using /lib/ in tests, use /src/ again. Fixed coverage testing.… Jun 6, 2018
.travis.yml run correct test script. Jun 16, 2018 Refactored `var` into `const`/`let`, and removed a lot of semicolons Jun 13, 2018 Released `v5.0.3` Jul 14, 2018
LICENSE Jake build script implemented Feb 16, 2013
NOTICE Released v3.19.0 Jan 6, 2018 Minor tweaks in the docs Jun 16, 2018
composer.json Updated history Jan 27, 2018
core.js Fix most lint errors using `npx standard --fix` Jun 10, 2018
gulpfile.js Woohoo fixed the last lint errors Jun 13, 2018
index.js Fixed incompatibility with v4 (index.js file) Jun 13, 2018
package-lock.json Merge branch 'enable-constants-without-complex' of… Jul 7, 2018
package.json Released `v5.0.3` Jul 14, 2018


Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser with support for symbolic computation, comes with a large set of built-in functions and constants, and offers an integrated solution to work with different data types like numbers, big numbers, complex numbers, fractions, units, and matrices. Powerful and easy to use.

Version Downloads Build Status Maintenance License FOSSA Status Slack


  • Supports numbers, big numbers, complex numbers, fractions, units, strings, arrays, and matrices.
  • Is compatible with JavaScript's built-in Math library.
  • Contains a flexible expression parser.
  • Does symbolic computation.
  • Comes with a large set of built-in functions and constants.
  • Can be used as a command line application as well.
  • Runs on any JavaScript engine.
  • Is easily extensible.
  • Open source.


Math.js can be used in both node.js and in the browser.

Install math.js using npm:

npm install mathjs

Or download mathjs via one of the CDN's listed on the downloads page:

Math.js can be used similar to JavaScript's built-in Math library. Besides that, math.js can evaluate expressions and supports chained operations.

// load math.js
const math = require('mathjs')

// functions and constants
math.round(math.e, 3)             // 2.718
math.atan2(3, -3) / math.pi       // 0.75
math.log(10000, 10)               // 4
math.sqrt(-4)                     // 2i
math.pow([[-1, 2], [3, 1]], 2)    // [[7, 0], [0, 7]]
math.derivative('x^2 + x', 'x')   // 2 * x + 1

// expressions
math.eval('12 / (2.3 + 0.7)')     // 4
math.eval('12.7 cm to inch')      // 5 inch
math.eval('sin(45 deg) ^ 2')      // 0.5
math.eval('9 / 3 + 2i')           // 3 + 2i
math.eval('det([-1, 2  3, 1])')   // -7

// chaining
    .done()  // 14

See the Getting Started for a more detailed tutorial.

Browser support

Math.js works on any ES5 compatible JavaScript engine: node.js 4 or newer, Chrome, Firefox, Safari, Edge, and IE11.

Though there is no official support for older browsers, math.js should still work on older browsers when using the es5-shim.



First clone the project from github:

git clone git://
cd mathjs

Install the project dependencies:

npm install

Then, the project can be build by executing the build script via npm:

npm run build

This will build the library math.js and math.min.js from the source files and put them in the folder dist.


To execute tests for the library, install the project dependencies once:

npm install

Then, the tests can be executed:

npm test

Additionally, the tests can be run on FireFox using headless mode:

npm run test:browser

To run the tests on remotely on BrowserStack, first set the environment variables BROWSER_STACK_USERNAME and BROWSER_STACK_ACCESS_KEY with your username and access key and then execute:

npm run test:browserstack

To test code coverage of the tests:

npm run coverage

To see the coverage results, open the generated report in your browser:


Continuous integration testing

Continuous integration tests are run on Travis CI and BrowserStack every time a commit is pushed to github. The test results can be checked on Travis CI runs the tests for different versions of node.js, and BrowserStack runs the tests are run on all major browsers.

Travis CI     BrowserStack

Thanks Travis CI and BrowserStack for the generous free hosting of this open source project!


Copyright (C) 2013-2018 Jos de Jong

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.