--- title: Math.min() slug: Web/JavaScript/Reference/Global_Objects/Math/min tags: - JavaScript - Math - Method - Reference translation_of: Web/JavaScript/Reference/Global_Objects/Math/min ---
{{JSRef("Global_Objects", "Math")}}

Сводка

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

Синтаксис

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

Параметры

value1, value2, ...
Числа.

Описание

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

При вызове без аргументов результатом вызова будет значение {{jsxref("Global_Objects/Infinity", "Infinity")}}.

Если хотя бы один из аргументов не может быть преобразован в число, результатом будет {{jsxref("Global_Objects/NaN", "NaN")}}.

Примеры

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

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

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

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

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

var x = f(foo);

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

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

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

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

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

{{Specifications}}

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

{{Compat}}

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