Math.min()

Summary

The Math.min() function returns the smallest of zero or more numbers.

Syntax

Math.min([value1[,value2, ...]]) 

Parameters

value1, value2, ...

Numbers.

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.

If no arguments are given, the result is Infinity.

If at least one of arguments cannot be converted to a number, the result is NaN.

Examples

Example: 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);

Example: 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);

Specifications

Browser compatibility

See also

• The Math object it belongs to.
• Math.max()