Math.max()

Exemple interactif

console.log(Math.max(1, 3, 2));
// Expected output: 3

console.log(Math.max(-1, -3, -2));
// Expected output: -1

const array1 = [1, 3, 2];

console.log(Math.max(...array1));
// Expected output: 3

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

Le plus grand des nombres passés en arguments. S'il existe un des arguments qui ne peut pas être converti en nombre, c'est NaN qui sera renvoyé. Si aucun paramètre n'est passé, c'est -Infinity qui est renvoyé.

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);

Spécifications

Compatibilité des navigateurs

Voir aussi

• Math.min()