HOWTO · JavaScript
Carrer un nombre en JavaScript
Ce tutoriel explique comment mettre un nombre au carré en JavaScript
Sur cette page
Pour mettre une valeur au carré en JavaScript, élevez-la à la puissance deux avec number ** 2. Par exemple, 5 ** 2 donne 25. C’est le choix le plus clair pour les valeurs Number courantes ; la multiplication et Math.pow() sont également possibles.
Mettre un Number au carré en JavaScript
Le carré d’une valeur est le produit de cette valeur par elle-même. En JavaScript, le type Number est le choix habituel pour les calculs courants, qu’il s’agisse d’entiers ou de nombres décimaux. L’exemple autonome suivant montre l’expression directe et affiche son résultat. Le code et les libellés ou sorties affichés dans cet exemple restent en anglais :
const number = 5;
console.log(number ** 2);
La valeur qui suit ** est l’exposant. Utilisez 2 pour calculer un carré, 3 pour un cube ou un autre exposant pour obtenir une puissance différente. Cette opération fonctionne aussi avec des valeurs Number négatives ou fractionnaires ; par exemple, le carré d’une valeur négative est non négatif. Les nombres JavaScript reposent sur l’arithmétique à virgule flottante : les calculs portant sur des valeurs très grandes ou des décimales exigeant une grande précision peuvent donc ne pas conserver tous les chiffres mathématiques.
Utiliser l’opérateur d’exponentiation
Le symbole ** est l’opérateur d’exponentiation, et non une méthode. Son opérande gauche est la base et son opérande droit est l’exposant ; base ** 2 exprime donc directement le calcul du carré. Pour une variable, affectez le résultat de cette expression comme celui de tout autre calcul. Le code et les libellés ou sorties affichés dans cet exemple restent en anglais :
const base = 8;
const squared = base ** 2;
console.log(squared);
Lorsque vous écrivez une base négative sous forme de littéral, mettez-la entre parenthèses : (-3) ** 2 calcule le carré de moins trois. Sans parenthèses, la négation unaire et l’exponentiation ne sont pas regroupées de la même façon, et -3 ** 2 provoque une erreur de syntaxe. Si la valeur est déjà stockée dans une variable, value ** 2 ne nécessite pas de parenthèses supplémentaires.
Utiliser la multiplication ou Math.pow()
Vous pouvez aussi multiplier une valeur par elle-même. Cette forme peut être facile à lire lorsque l’on veut décrire explicitement l’opération, tandis que ** rend l’exposant visible. L’ancienne fonction intégrée Math.pow(base, exponent) exprime la même relation entre une base et un exposant ; elle reste utile dans le code qui suit cette convention. Le code et les libellés ou sorties affichés dans cet exemple restent en anglais :
const number = 5;
const byMultiplication = number * number;
const byMathPow = Math.pow(number, 2);
console.log(byMultiplication, byMathPow);
Pour les valeurs Number courantes, ces trois formes calculent une puissance à l’aide de la représentation des nombres à virgule flottante de JavaScript. Choisissez la notation qui s’accorde le mieux avec le code environnant ; aucune de ces solutions ne fournit une arithmétique décimale exacte à précision arbitraire.
Encapsuler le calcul du carré dans une fonction réutilisable
Si vous devez effectuer le même calcul à plusieurs endroits, placez-le dans une fonction. Une fonction nommée convient lorsque vous souhaitez disposer d’une déclaration réutilisable ; une fonction fléchée constitue une option plus concise, notamment pour les fonctions de rappel. Les exemples ci-dessous définissent puis appellent chacune de ces formes. Le code et les libellés ou sorties affichés dans ces exemples restent en anglais :
function squareNumber(value) {
return value ** 2;
}
console.log(squareNumber(6));
const square = (value) => value ** 2;
console.log(square(6));
Les deux fonctions acceptent une valeur et renvoient son carré. Elles ne valident pas leur entrée et ne la convertissent pas ; les appelants doivent donc fournir une valeur dont le comportement numérique correspond à leurs besoins. Par exemple, multiplier une chaîne après conversion implicite peut produire un résultat inattendu. Si nécessaire, convertissez et validez les données externes avant d’appeler la fonction utilitaire.
Mettre au carré des valeurs BigInt lorsque la précision des grands entiers compte
Les valeurs Number de JavaScript ne représentent exactement les entiers que jusqu’à Number.MAX_SAFE_INTEGER (9,007,199,254,740,991). Si le calcul entier doit rester exact au-delà de cette limite, utilisez BigInt dès le départ. Ajoutez le suffixe n à un littéral entier, puis employez le même opérateur d’exponentiation. Le code et les libellés ou sorties affichés dans cet exemple restent en anglais :
const largeInteger = 9007199254740993n;
const squared = largeInteger ** 2n;
console.log(squared);
L’exposant d’un BigInt doit lui aussi être un BigInt, d’où le 2n dans l’exemple. BigInt prend en charge les entiers, pas les nombres fractionnaires. JavaScript interdit de mélanger directement des opérandes BigInt et Number dans une opération arithmétique : effectuez une conversion délibérée lorsque c’est approprié, en gardant à l’esprit que convertir un Number déjà imprécis ne permet pas de récupérer les chiffres perdus. Utilisez Number pour les calculs numériques courants et BigInt lorsque vous avez besoin de calculs exacts sur de grands entiers.