JavaScript Math min()

In this tutorial, you will learn about the JavaScript Math.min() method with the help of examples.

The min() method finds the minimum value among the specified values and returns it.

Example

let numbers = Math.min(12, 4, 5, 9, 0, -3);
console.log(numbers); 

// Output:  -3

min() Syntax

The syntax of the min() method is:

Math.min(number1, number2,....)

Here, min() is a static method. Hence, we are accessing the method using the class name, Math.


min() Parameters

The min() method takes in a random number of parameters:

  • number1/number2/… - values among which the minimum number is to be computed

min() Return Value

The min() method returns:

  • the smallest value among the given numbers
  • NaN (Not a Number) for non-numeric arguments

Example 1: JavaScript Math.min()

// min() with negative numbers let numbers1 = Math.min(-1, -11, -132)
; console.log(numbers1);
// min() with positive numbers let numbers2 = Math.min(0.456, 135, 500);
console.log(numbers2); // Output: // -132 // 0.456

In the above example, we have used Math.min() to find the minimum number among:

  • Math.min(-1,-11,-132) - returns -132
  • Math.min(0.456,135,500) - returns 0.456

Example 2: Math.min() with Arrays

let numbers = [4, 1, 2, 55, 9];

// min() with a spread operator let minNum = Math.min(...numbers);
console.log(minNum); // Output: 1

In the above example, we have created an array named numbers. Notice that we are passing the array as an argument to the Math.min() method.

let minNum = Math.min(...numbers);

Here, ... is the spread operator that destructures the array and passes the array values as arguments to min().

The method then finds the smallest number.


Example 3: Math.min() with Non-Numeric Argument

// min() with string argument let numbers1 = Math.min("Dwayne", 2, 5, 79);
console.log(numbers1);
// min() with characters arguments let minNum = Math.min('A', 'B', 'C');
console.log(minNum); // Output: // NaN // NaN

In the above example, we have used the min() method with the string and character arguments. For both arguments, we get NaN as output.


Recommended readings:

Did you find this article helpful?