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 July 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 Language Specification
# sec-math.min

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

BCD tables only load in the browser

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