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.

A função Math.min() retorna o menor valor passado como parâmetro, ou NaN se o parâmetro não é ou não pode ser convertido para um número.

Syntax

Math.min([valor1[, valor2[, ...]]])

Parâmetros

Descrição

Por que min() é um método estático de Math, você sempre usa como Math.min(), e não como um método de um objeto Math que você criou (Math não é um construtor).

Se nenhum argumento for dado, o resultado é Infinity.

Se pelo menos um dos argumentos não pode ser convertido para um número, o resultado é NaN.

Exemplos

Usando Math.min()

Este encontra o min de x e y e atribui a z :

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

Cortando um valor com Math.min()

Math.min() é muitas vezes usado para cortar um valor sempre menor do que ou igual a um limite. Por exemplo, este.

var x = f(foo);

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

pode ser escrita como este

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

Math.max() pode ser usado de uma maneira semelhante ao corte de um valor na outra extremidade.

Especificações

Specification
ECMAScript Language Specification
# sec-math.min

Compatibilidade do navegador

BCD tables only load in the browser

Veja Também