CKTIS / JavaScript
Math.min : plus petite valeur
Math.min convertit chaque argument en Number et renvoie la plus petite valeur obtenue.
Version : ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
Math.min(...args)Math.min(...args) applique d’abord ToNumber à tous les arguments dans l’ordre, puis choisit le plus petit résultat. Sans argument, elle renvoie Infinity, élément neutre de la recherche du minimum. Si une conversion donne NaN, le résultat est NaN ; toutes les conversions ont néanmoins lieu avant ce test.
Les chaînes numériques et autres valeurs convertibles sont acceptées, tandis que Symbol ou BigInt lève TypeError. Un objet peut exécuter valueOf ou toString, et une erreur de conversion interrompt l’appel. Entre les deux zéros, -0 est considéré inférieur à +0 ; -Infinity est inférieur à tout Number fini.
La fonction existe depuis ECMAScript 1 et n’est pas un constructeur. Pour un petit tableau, Math.min(...values) est pratique. N’étalez pas une très grande collection, car la limite d’arguments dépend du moteur ; employez une boucle ou reduce et définissez le traitement du vide et de NaN.
Exemples
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(","));Résultat
-4 Infinity true true 2 true true a,b
Math.min → -4 and ordered coercion a,b