Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Math.max : plus grande valeur

Math.max convertit chaque argument en Number et renvoie la plus grande valeur obtenue.

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

Syntaxe

Math.max(...args)

Math.max(...args) applique d’abord ToNumber à tous les arguments dans l’ordre, puis choisit le plus grand résultat. Sans argument, elle renvoie -Infinity, élément neutre de la recherche du maximum. 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é supérieur à -0 ; Infinity dépasse tout Number fini.

La fonction existe depuis ECMAScript 1 et n’est pas un constructeur. Pour un petit tableau, Math.max(...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.max(...scores));
console.log(Math.max(), Number.isNaN(Math.max(3, undefined)));
console.log(Object.is(Math.max(-0, +0), +0));
console.log(Math.max("6", 2));
try { Math.max(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.max(a, b)), seen.join(","));

Résultat

12
-Infinity true
true
6
true
true a,b

Math.max → 12 and ordered coercion a,b

Sources