Math.min()

Статический метод Math.min() возвращает наименьшее из чисел, указанных в качестве входных параметров, или Infinity, если параметров нет.

Попробуйте

console.log(Math.min(2, 3, 1));
// Expected output: 1

console.log(Math.min(-2, -3, -1));
// Expected output: -3

const array = [2, 3, 1];

console.log(Math.min(...array));
// Expected output: 1

Синтаксис

Math.min()
Math.min(value1)
Math.min(value1, value2)
Math.min(value1, value2, /* …, */ valueN)

Параметры

value1, …, valueN

Ноль или более чисел, из которых будет выбрано и возвращено наименьшее значение.

Возвращаемое значение

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

Описание

Поскольку min() является статическим методом Math, вы всегда используете его как Math.min(), а не как метод созданного вами объекта Math (Math не является конструктором).

Math.min.length равен 2, что косвенно указывает на то, что он предназначен для обработки как минимум двух параметров.

Примеры

Использование Math.min()

Это находит минимум из x и y и присваивает его z:

const x = 10;
const y = -20;
const z = Math.min(x, y); // -20

Ограничение значения с помощью Math.min()

Math.min() часто используется для ограничения значения, чтобы оно всегда было меньше или равно границе. Например, это

let x = f(foo);

if (x > boundary) {
  x = boundary;
}

может быть записано так:

const x = Math.min(f(foo), boundary);

Math.max() может использоваться аналогичным образом для ограничения значения с другой стороны.

Спецификации

Совместимость с браузерами

См. также

• Math.max()