CKTIS / JavaScript
Opérateur de soustraction (-)
L’opérateur binaire `-` soustrait l’opérande de droite de celui de gauche. Il convertit les opérandes en valeurs numériques et accepte soit `Number`, soit `BigInt`, mais ne permet pas de mélanger ces types.
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
left - rightL’expression left - right renvoie la différence : l’opérande de droite est soustrait de celui de gauche. La soustraction binaire se distingue de -value unaire, qui change le signe d’une valeur. La soustraction n’assigne pas elle-même son résultat à l’un ou l’autre des opérandes.
L’opérateur convertit les opérandes à l’aide de ToNumeric. Deux valeurs Number produisent une valeur Number, et deux valeurs BigInt produisent une valeur BigInt. Mélanger ces types, comme dans 10n - 3, déclenche une TypeError ; une conversion explicite est nécessaire. Contrairement à +, - ne concatène pas les chaînes : "10" - 3 produit 7, tandis que "hello" - 3 produit NaN.
La soustraction est associative à gauche : 10 - 3 - 2 signifie (10 - 3) - 2. La multiplication est prioritaire. Les calculs avec Number peuvent entraîner des arrondis en virgule flottante ; BigInt permet une soustraction exacte des entiers.
Exemples
console.log(10 - 3);
console.log("10" - 3);
console.log(String(10n - 3n));
console.log(Number.isNaN("hello" - 3));
try {
console.log(10n - 3);
} catch (error) {
console.log(error.name);
}Résultat
7 7 7 true TypeError
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.