Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



    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
    var 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 0.10, and Internet Explorer 9 and newer, and all other browsers (Chrome, Firefox, Safari). If support for old browsers like Internet Explorer 8 is required, the es5-shim library has to be loaded.



    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

    To test code coverage of the tests:

    npm run coverage

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


    Automated cross browser testing for mathjs is generously provided by BrowserStack



    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.


    npm i mathjs

    Downloadsweekly downloads









    last publish


    • avatar