CKTIS / JavaScript
Moins unaire
Le moins unaire (`unary minus`), écrit `-expression`, convertit son opérande en valeur numérique et renvoie son opposé. Il prend en charge `Number` et `BigInt` ; le résultat n’est pas réaffecté à la variable.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
-expressionL’opérateur unary minus s’écrit -expression. Il prend un seul opérande, contrairement à la soustraction a - b, qui en prend deux. Il renvoie la valeur opposée : -7 produit un nombre négatif, tandis que -(-7) en produit un positif. Dans -value, l’opérateur n’affecte pas le résultat à la variable value. Toutefois, si value contient un objet, le code exécuté lors de sa conversion peut affecter une autre valeur à cette variable.
La conversion ToNumeric a lieu en premier. Une valeur Number reste un Number, et un BigInt reste un BigInt : -12n produit -12n. La chaîne "12" est convertie en nombre ; -"12" produit donc -12. La chaîne "hello" produit NaN, tandis qu’un opérande de type Symbol provoque une TypeError. La conversion d’un objet peut exécuter son propre code et déclencher une exception.
Pour Number, l’opérateur transforme +0 en -0 et inversement ; la négation de NaN produit toujours NaN. Le zéro négatif a son importance : 1 / -0 produit -Infinity. BigInt n’a pas de zéro négatif distinct ; -0n produit donc 0n.
L’exemple montre la négation sans affectation, la conversion d’une chaîne, la prise en charge de BigInt, le zéro négatif et NaN. L’appel String(-12n) rend cohérent l’affichage du résultat BigInt.
Exemples
const value = 7;
console.log(-value);
console.log(value);
console.log(-"12");
console.log(String(-12n));
console.log(1 / -0);
console.log(Number.isNaN(-"hello"));Résultat
-7 7 -12 -12 -Infinity true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.