The Math.min[]
function returns the smallest of the numbers given as input parameters, or Infinity
if there are no parameters.Try it
Syntax
Math.min[]
Math.min[value0]
Math.min[value0, value1]
Math.min[value0, value1, /* … ,*/ valueN]
Parameters
value1
, …, valueN
Zero or more numbers among which the lowest value will be selected and returned.
Return value
The smallest of the given numbers. Returns NaN
if any of the parameters is or is converted into NaN
. Returns
Infinity
if no parameters are provided.
Description
Because min[]
is a static method of Math
, you always use it as
Math.min[]
, rather than as a method of a Math
object you created [Math
is not a constructor].
Math.min.length
is 2, which weakly signals that it's designed to handle at least two parameters.
Examples
Using Math.min[]
This finds the min of x
and y
and
assigns it to z
:
const x = 10;
const y = -20;
const z = Math.min[x, y]; // -20
Clipping a value with Math.min[]
Math.min[]
is often used to clip a value so that it is always less than or equal to a
boundary. For instance, this
let x = f[foo];
if [x > boundary] {
x = boundary;
}
may be written as this
const x = Math.min[f[foo], boundary];
Math.max[]
can be used in a similar way to clip a value at the other end.
Specifications
ECMAScript Language Specification # sec-math.min |
Browser compatibility
BCD tables only load in the browser
See also
Definition and Usage
Number.MIN_VALUE
returns the smallest number possible in JavaScript.
Number.MIN_VALUE
has a value of 5e-324.
Note
MIN_VALUE is the value closest to 0.
Numbers smaller than this are converted to 0.
The most negative number is the negative MAX_NUMBER.
Number.MIN_VALUE
MIN_VALUE is a property of the JavaScript Number object.
You can only use it as Number.MIN_VALUE.
Using x.MIN_VALUE, where x is a variable, will return undefined:
Syntax
Return Value
Type | Description |
A number | 5e-324 |
Browser Support
Number.MIN_VALUE
is an ECMAScript1 [ES1] feature.
ES1 [JavaScript 1997] is fully supported in all browsers:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes | Yes |
More Examples
let a = Math.min[5, 10];
let b = Math.min[0, 150, 30, 20, 38];
let c = Math.min[-5, 10];
let d = Math.min[-5, -10];
let e = Math.min[1.5, 2.5];
Try it Yourself »
Definition and Usage
The Math.min[]
method returns the number with the lowest value.
Syntax
Parameters
Parameter | Description |
n1, n2,... | Optional. One or more numbers to compare. |
Return Value
Type | Description |
Number | The lowest number of the arguments.-Infinity if no arguments are given.NaN if one of the arguments is not a number.
|
Browser Support
Math.min[]
is an ECMAScript1 [ES1] feature.
ES1 [JavaScript 1997] is fully supported in all browsers:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes | Yes |