This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Math.min()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

Сводка

Метод Math.min() возвращает наименьшее из нуля или более чисел.

Синтаксис

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

Параметры

value1, value2, ...

Числа.

Описание

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

При вызове без аргументов результатом вызова будет значение Infinity.

Если хотя бы один из аргументов не может быть преобразован в число, результатом будет NaN.

Примеры

Пример: использование метода Math.min()

В этом примере ищется минимум из x и y и присваивается переменной z:

js
var x = 10,
  y = -20;
var z = Math.min(x, y);

Пример: обрезание значения при помощи метода Math.min()

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

js
var x = f(foo);

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

может быть переписано в виде

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

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

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

Specification
ECMAScript® 2026 Language Specification
# sec-math.min

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

Смотрите также