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() для обрезания значения по нижней границе.

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

Спецификация Статус Комментарии
ECMAScript 1-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
Определение 'Math.min' в этой спецификации.
Стандарт  
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Math.min' в этой спецификации.
Стандарт  

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

BCD tables only load in the browser

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