Math.min()

Сводка

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

Синтаксис

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

Параметры

value1, value2, ...

Числа.

Описание

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

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

Если хотя бы один из аргументов не может быть преобразован в число, результатом будет 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);

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

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

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

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

• Math.max()