Math.max()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
La méthode statique Math.max()
renvoie le plus grand nombre parmi ceux passés en paramètres, ou -Infinity
si aucun paramètre n'est fourni.
Exemple interactif
Syntaxe
Math.max()
Math.max(valeur0)
Math.max(valeur0, valeur1)
Math.max(valeur0, valeur1, /* … ,*/ valeurN)
Paramètres
valeur1
,valeur2
, … ,valeurN
-
Zéro ou plusieurs nombres dont le plus grand sera renvoyé par la méthode.
Valeur de retour
Description
max()
est une méthode statique de Math
et doit toujours être utilisée avec la syntaxe Math.max()
, elle ne doit pas être appelée comme la méthode d'un autre objet qui aurait été créé (Math
n'est pas un constructeur).
Math.max.length
vaut 2, un signal faible indiquant qu'elle est conçue pour au moins deux paramètres.
Exemples
Utiliser Math.max()
Math.max(10, 20); // 20
Math.max(-10, -20); // -10
Math.max(-10, 20); // 20
Obtenir l'élément maximum d'un tableau
La méthode Array.prototype.reduce()
peut être utilisée pour déterminer la valeur maximale d'un tableau de nombre en comparant les valeurs qui se suivent :
const arr = [1, 2, 3];
const max = arr.reduce((a, b) => Math.max(a, b), -Infinity);
On peut également utiliser Function.prototype.apply()
afin de trouver le maximum parmi un tableau de nombres. Avec la fonction suivante, getMaxTableau([1,2,3])
sera équivalent à Math.max(1, 2, 3)
, mais getMaxTableau
pourra être utilisé sur des tableaux construits dans les scripts. Cet usage est à réserver aux tableaux qui ont relativement peu d'éléments (voir avertissement ci-après).
function getMaxTableau(tableauNumérique) {
return Math.max.apply(null, tableauNumérique);
}
Avec la syntaxe de décomposition, on pourra également utiliser cette forme, plus concise :
const arr = [1, 2, 3];
const max = Math.max(...arr);
Attention : Utiliser la décomposition ou apply()
de cette façon pourra échouer s'il y a trop d'éléments dans le tableau (car ceux-ci seront passés en arguments). Pour plus d'informations, consulter Utiliser apply()
et les fonctions natives. La méthode proposée avec reduce()
n'a pas cette contrainte.
Spécifications
Specification |
---|
ECMAScript Language Specification # sec-math.max |
Compatibilité des navigateurs
BCD tables only load in the browser