Math : méthode statique min()

Exemple interactif

console.log(Math.min(2, 3, 1));
// Sortie attendue : 1

console.log(Math.min(-2, -3, -1));
// Sortie attendue : -3

const array = [2, 3, 1];

console.log(Math.min(...array));
// Sortie attendue : 1

Syntaxe

Math.min()
Math.min(value1)
Math.min(value1, value2)
Math.min(value1, value2, /* …, */ valueN)

Paramètres

value1, …, valueN

Zéro ou plusieurs nombres parmi lesquels la plus petite valeur est sélectionnée et retournée.

Valeur de retour

Le plus petit des nombres passés en arguments. Retourne NaN si l'un des paramètres est ou est converti en NaN. Retourne Infinity si aucun paramètre n'est fourni.

Description

Puisque min() est une méthode statique de Math, elle doit toujours être utilisée avec la syntaxe Math.min(), elle ne doit pas être appelée comme la méthode d'un autre objet qui a été créé (Math n'est pas un constructeur).

Math.min.length vaut 2, un signal faible indiquant qu'elle est conçue pour au moins deux paramètres.

Exemples

Utiliser Math.min()

Dans cet exemple, on trouve le minimum de x et y et on affecte cette valeur à z :

const x = 10;
const y = -20;
const z = Math.min(x, y); // -20

Ramener une valeur dans un intervalle avec Math.min()

Math.min() est souvent utilisée afin de ramener une certaine valeur dans un intervalle donné (clipping en anglais). Par exemple :

let x = f(toto);

if (x > limite) {
  x = limite;
}

peut s'écrire comme ceci

const x = Math.min(f(toto), limite);

Math.max() peut être utilisée de façon semblable pour ramener une valeur vers un minimum d'un intervalle donné.

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthode statique Math.max()