La fonction Math.min()
renvoie le plus petit nombre d'une série de 0 ou plusieurs nombres ou bien NaN
si au moins un des arguments fourni n'est pas un nombre ou ne peut pas être converti en nombre.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
Math.min([valeur1[,valeur2, ...]])
Paramètres
valeur1, valeur2, ...
- Des nombres.
Valeur de retour
Le plus petit des nombres passés en arguments. S'il existe un argument qui ne peut pas être converti en nombre, c'est NaN
qui sera renvoyé. Le résultat sera Infinity
si aucun paramètre n'est fourni.
Description
min()
est une méthode statique de Math
, elle doit toujours être utilisée avec la syntaxe Math.min()
et ne doit pas être utilisée comme la méthode d'un objet qui aurait été créé (Math
n'est pas un constructeur).
Si aucun argument n'est fourni, le résultat renvoyé par la fonction sera Infinity
.
Si au moins un des arguments ne peut pas être converti en un nombre, le résultat sera NaN
.
Exemples
Utiliser Math.min()
Dans cet exemple, on trouve le minimum de x et y et on affecte cette valeur à z :
var x = 10, y = -20;
var z = Math.min(x, y);
Ramener une valeur dans un intervalle (clipping) avec Math.min()
Math.min()
est souvent utilisée afin de ramener une certaine valeur dans un intervalle donné. Par exemple :
var x = f(toto);
if (x > limite) {
x = limite;
}
peut s'écrire
var 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
Spécification | Statut | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.0. |
ECMAScript 5.1 (ECMA-262) La définition de 'Math.min' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Math.min' dans cette spécification. |
Standard | |
ECMAScript (ECMA-262) La définition de 'Math.min' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.