Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

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 ⁨julho de 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

valor1, valor2, ...

Números.

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

Compatibilidade do navegador

Veja Também