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' в этой спецификации.
Стандарт  

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

Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) (Да) (Да) (Да)
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)

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

Метки документа и участники

 Внесли вклад в эту страницу: sergey.karavaev, Mingun, teoli, Ladislas
 Обновлялась последний раз: sergey.karavaev,