Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Math.min: valore minore

Math.min converte ogni argomento in Number e restituisce il minore dei valori ottenuti.

Versione: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintassi

Math.min(...args)

Math.min(...args) applica prima ToNumber a tutti gli argomenti in ordine e poi sceglie il risultato minore. Senza argomenti restituisce Infinity, elemento neutro della ricerca del minimo. Se un valore convertito è NaN, il risultato è NaN; tutte le conversioni avvengono comunque prima di questo controllo.

Accetta stringhe numeriche e altri valori convertibili, mentre Symbol o BigInt genera TypeError. Gli oggetti possono eseguire valueOf o toString e un errore di conversione interrompe la chiamata. Tra i due zeri -0 è considerato minore di +0; -Infinity è minore di ogni Number finito.

La funzione esiste da ECMAScript 1 e non è un costruttore. Per un array piccolo è pratico Math.min(...values). Non espandere collezioni enormi perché il limite degli argomenti dipende dal motore; usa un ciclo o reduce e definisci il comportamento per input vuoto e NaN.

Esempi

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(","));

Risultato

-4
Infinity true
true
2
true
true a,b

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

Fonti