File size: 7,070 Bytes
780c9fe |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 |
---
title: Math
slug: Web/JavaScript/Reference/Global_Objects/Math
page-type: javascript-namespace
browser-compat: javascript.builtins.Math
sidebar: jsref
---
The **`Math`** namespace object contains static properties and methods for mathematical constants and functions.
`Math` works with the {{jsxref("Number")}} type. It doesn't work with {{jsxref("BigInt")}}.
## Description
Unlike most global objects, `Math` is not a constructor. You cannot use it with the [`new` operator](/en-US/docs/Web/JavaScript/Reference/Operators/new) or invoke the `Math` object as a function. All properties and methods of `Math` are static.
> [!NOTE]
> Many `Math` functions have a precision that's _implementation-dependent_.
>
> This means that different browsers can give a different result. Even the same JavaScript engine on a different OS or architecture can give different results!
## Static properties
- {{jsxref("Math.E")}}
- : Euler's number and the base of natural logarithms; approximately `2.718`.
- {{jsxref("Math.LN10")}}
- : Natural logarithm of `10`; approximately `2.303`.
- {{jsxref("Math.LN2")}}
- : Natural logarithm of `2`; approximately `0.693`.
- {{jsxref("Math.LOG10E")}}
- : Base-10 logarithm of `E`; approximately `0.434`.
- {{jsxref("Math.LOG2E")}}
- : Base-2 logarithm of `E`; approximately `1.443`.
- {{jsxref("Math.PI")}}
- : Ratio of a circle's circumference to its diameter; approximately `3.14159`.
- {{jsxref("Math.SQRT1_2")}}
- : Square root of ½; approximately `0.707`.
- {{jsxref("Math.SQRT2")}}
- : Square root of `2`; approximately `1.414`.
- `Math[Symbol.toStringTag]`
- : The initial value of the [`[Symbol.toStringTag]`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag) property is the string `"Math"`. This property is used in {{jsxref("Object.prototype.toString()")}}.
## Static methods
- {{jsxref("Math.abs()")}}
- : Returns the absolute value of the input.
- {{jsxref("Math.acos()")}}
- : Returns the arccosine of the input.
- {{jsxref("Math.acosh()")}}
- : Returns the hyperbolic arccosine of the input.
- {{jsxref("Math.asin()")}}
- : Returns the arcsine of the input.
- {{jsxref("Math.asinh()")}}
- : Returns the hyperbolic arcsine of a number.
- {{jsxref("Math.atan()")}}
- : Returns the arctangent of the input.
- {{jsxref("Math.atan2()")}}
- : Returns the arctangent of the quotient of its arguments.
- {{jsxref("Math.atanh()")}}
- : Returns the hyperbolic arctangent of the input.
- {{jsxref("Math.cbrt()")}}
- : Returns the cube root of the input.
- {{jsxref("Math.ceil()")}}
- : Returns the smallest integer greater than or equal to the input.
- {{jsxref("Math.clz32()")}}
- : Returns the number of leading zero bits of the 32-bit integer input.
- {{jsxref("Math.cos()")}}
- : Returns the cosine of the input.
- {{jsxref("Math.cosh()")}}
- : Returns the hyperbolic cosine of the input.
- {{jsxref("Math.exp()")}}
- : Returns e<sup>x</sup>, where x is the argument, and e is Euler's number (`2.718`…, the base of the natural logarithm).
- {{jsxref("Math.expm1()")}}
- : Returns subtracting `1` from `exp(x)`.
- {{jsxref("Math.floor()")}}
- : Returns the largest integer less than or equal to the input.
- {{jsxref("Math.f16round()")}}
- : Returns the nearest [half precision](https://en.wikipedia.org/wiki/Half-precision_floating-point_format) float representation of the input.
- {{jsxref("Math.fround()")}}
- : Returns the nearest [single precision](https://en.wikipedia.org/wiki/Single-precision_floating-point_format) float representation of the input.
- {{jsxref("Math.hypot()")}}
- : Returns the square root of the sum of squares of its arguments.
- {{jsxref("Math.imul()")}}
- : Returns the result of the 32-bit integer multiplication of the inputs.
- {{jsxref("Math.log()")}}
- : Returns the natural logarithm (㏒<sub>e</sub>; also, ㏑) of the input.
- {{jsxref("Math.log10()")}}
- : Returns the base-10 logarithm of the input.
- {{jsxref("Math.log1p()")}}
- : Returns the natural logarithm (㏒<sub>e</sub>; also ㏑) of `1 + x` for the number `x`.
- {{jsxref("Math.log2()")}}
- : Returns the base-2 logarithm of the input.
- {{jsxref("Math.max()")}}
- : Returns the largest of zero or more numbers.
- {{jsxref("Math.min()")}}
- : Returns the smallest of zero or more numbers.
- {{jsxref("Math.pow()")}}
- : Returns base `x` to the exponent power `y` (that is, `x`<sup><code>y</code></sup>).
- {{jsxref("Math.random()")}}
- : Returns a pseudo-random number between `0` and `1`.
- {{jsxref("Math.round()")}}
- : Returns the value of the input rounded to the nearest integer.
- {{jsxref("Math.sign()")}}
- : Returns the sign of the input, indicating whether it is positive, negative, or zero.
- {{jsxref("Math.sin()")}}
- : Returns the sine of the input.
- {{jsxref("Math.sinh()")}}
- : Returns the hyperbolic sine of the input.
- {{jsxref("Math.sqrt()")}}
- : Returns the positive square root of the input.
- {{jsxref("Math.sumPrecise()")}}
- : Returns the sum of a passed iterable of numbers, avoiding floating point precision loss in intermediate results.
- {{jsxref("Math.tan()")}}
- : Returns the tangent of the input.
- {{jsxref("Math.tanh()")}}
- : Returns the hyperbolic tangent of the input.
- {{jsxref("Math.trunc()")}}
- : Returns the integer portion of the input, removing any fractional digits.
## Examples
### Converting between degrees and radians
The trigonometric functions `sin()`, `cos()`, `tan()`, `asin()`, `acos()`, `atan()`, and `atan2()` expect (and return) angles in _radians_.
Since humans tend to think in degrees, and some functions (such as CSS transforms) can accept degrees, it is a good idea to keep functions handy that convert between the two:
```js
function degToRad(degrees) {
return degrees * (Math.PI / 180);
}
function radToDeg(rad) {
return rad / (Math.PI / 180);
}
```
### Calculating the height of an equilateral triangle
If we want to calculate the height of an equilateral triangle, and we know its side length is 100, we can use the formulae _length of the adjacent multiplied by the tangent of the angle is equal to the opposite._

In JavaScript, we can do this with the following:
```js
50 * Math.tan(degToRad(60));
```
We use our `degToRad()` function to convert 60 degrees to radians, as {{jsxref("Math.tan()")}} expects an input value in radians.
### Returning a random integer between two bounds
This can be achieved with a combination of {{jsxref("Math.random()")}} and {{jsxref("Math.floor()")}}:
```js
function random(min, max) {
const num = Math.floor(Math.random() * (max - min + 1)) + min;
return num;
}
random(1, 10);
```
## Specifications
{{Specifications}}
## Browser compatibility
{{Compat}}
## See also
- {{jsxref("Number")}}
|