The static function Math.min()
returns the lowest-valued number passed into it, or NaN
if any parameter isn't a number and can't be converted into one.
Math.min()
Try it
Syntax
Math.min() Math.min(value0) Math.min(value0, value1) Math.min(value0, value1, ... , valueN)
Parameters
-
value1, value2, ...
-
Zero or more numbers among which the lowest value will be selected and returned.
Return value
Description
Examples
Using Math.min()
This finds the min of x
and y
and assigns it to z
:
var x = 10, y = -20; var z = Math.min(x, y);
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
var x = f(foo); if (x > boundary) { x = boundary; }
may be written as this
var x = Math.min(f(foo), boundary);
Math.max()
can be used in a similar way to clip a value at the other end.
Specifications
Specification |
---|
ECMAScript Language Specification # sec-math.min |
Browser compatibility
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | Deno | Node.js | |
min |
1
|
12
|
1
|
3
|
3
|
1
|
1
|
18
|
4
|
10.1
|
1
|
1.0
|
1.0
|
0.10.0
|
See also
© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/min