JavaScript метод min()

Определение и применение

JavaScript метод min() объекта Math позволяет найти и возвратить наименьшее из переданных чисел.

Обращаю Ваше внимание на то, что если хотя бы один из переданных параметров не может быть преобразован в число, то результатом вызова метода будет значение NaN.

Если метод min() вызывается без параметров, то в качестве возвращаемого значения возвращается значение Infinity.

Поддержка браузерами

Метод	Chrome	Firefox	Opera	Safari	IExplorer	Edge
min()	Да	Да	Да	Да	Да	Да

JavaScript синтаксис:

Math.min( value1, value2, ...valueX ); 

value - Number

Версия JavaScript

Значения параметров

Пример использования

Базовое использование

const a = 5,
      b = -12,
      c = 20;

// находим минимальное число из переданных значений
Math.min(a, b, c); // возвращаемое значение 5

// находим максимальное число из переданных значений
Math.max(a, b, c); // возвращаемое значение 20

Обрезание значения

В следующем примере мы рассмотрим как с помощью методов min() и max() объекта Math обрезать значение по верхней или нижней границе, если оно превышает или меньше определенного значения:

const a = someFunc(num);

// условие без использования метода min
if (a > boundary) {
  a = boundary;
}

// перепишем условие с помощью метода min
const val = Math.min(a, boundary); // если значение параметра a будет больше значения парметра boundary, то будет выбрано значение параметра boundary

const b = someFunc(num);

// условие без использования метода max
if (b < boundary) {
  b = boundary;
}

// перепишем условие с помощью метода max
const b = Math.max(b, boundary); // если значение параметра b будет меньше значения парметра boundary, то будет выбрано значение параметра boundary

Минимальное и максимальное значение в массиве

В следующем примере мы рассмотрим как с помощью методов min() и max() объекта Math найти минимальное и максимальное значение внутри массива.

// инициализируем переменную, содержащую массив
const arr = [-10, 22, 5, -2];

// находим минимальное число в массиве
Math.min.apply( null, arr ); // возвращаемое значение -10

// находим максимальное число в массиве
Math.max.apply( null, arr ); // возвращаемое значение 22

// тоже самое с помощью спред оператора ES2015

Math.min(...arr); // возвращаемое значение -10
Math.max(...arr); // возвращаемое значение 22

Обратите внимание, что в первом случае был использован метод apply() объекта Function.