Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Math.min: menor valor

Math.min converte cada argumento para Number e devolve o menor dos valores resultantes.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

Math.min(...args)

Math.min(...args) aplica primeiro ToNumber a todos os argumentos por ordem e depois escolhe o menor resultado. Sem argumentos devolve Infinity, o elemento neutro da procura do mínimo. Se algum valor convertido for NaN, o resultado é NaN; todas as conversões ocorrem, contudo, antes desse teste.

Aceita strings numéricas e outros valores convertíveis, enquanto Symbol ou BigInt lança TypeError. Objetos podem executar valueOf ou toString, e um erro de conversão interrompe a chamada. Entre os dois zeros, -0 é considerado menor do que +0; -Infinity é inferior a todo Number finito.

A função existe desde ECMAScript 1 e não é construtor. Para um array pequeno, Math.min(...values) é prático. Não espalhes coleções enormes, pois o limite de argumentos depende do motor; usa um ciclo ou reduce e define o tratamento de entrada vazia e NaN.

Exemplos

const scores = [-4, 12, 7];
console.log(Math.min(...scores));
console.log(Math.min(), Number.isNaN(Math.min(3, undefined)));
console.log(Object.is(Math.min(-0, +0), -0));
console.log(Math.min("6", 2));
try { Math.min(1n, 2); } catch (error) { console.log(error instanceof TypeError); }
const seen = [];
const a = { valueOf() { seen.push("a"); return NaN; } };
const b = { valueOf() { seen.push("b"); return 4; } };
console.log(Number.isNaN(Math.min(a, b)), seen.join(","));

Resultado

-4
Infinity true
true
2
true
true a,b

Math.min → -4 and ordered coercion a,b

Fontes