Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Affectation avec soustraction (-=)

L’opérateur -= soustrait l’opérande de droite de la valeur actuelle de l’opérande de gauche et stocke le résultat au même emplacement. Il effectue une conversion numérique, et l’expression entière renvoie la valeur affectée.

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

target -= expression

L’opérateur -= combine soustraction et affectation. Pour une variable simple, x -= y fonctionne comme x = x - y, mais l’expression qui désigne l’opérande de gauche n’est évaluée qu’une seule fois. Cela compte lorsqu’on accède à une propriété ou à un élément de tableau avec des effets de bord.

L’emplacement de stockage est d’abord déterminé et sa valeur est lue ; l’opérande de droite est ensuite évalué. La conversion numérique est suivie de la soustraction et du stockage. La valeur de l’expression entière est le résultat de la soustraction.

Après conversion, les deux opérandes doivent être de type Number ou tous deux de type BigInt ; mélanger ces types déclenche une TypeError. Un texte représentant un nombre, comme "12", peut être converti en Number. Contrairement à +=, l’opérateur -= ne concatène pas les chaînes.

L’opérande de gauche doit être une cible d’affectation valide. Tenter de modifier une variable déclarée avec const déclenche une TypeError. Dans l’exemple, remaining devient le nombre 7 et result reçoit la même valeur.

Exemples

let remaining = "12";
const result = (remaining -= 5);
console.log(remaining);
console.log(result);
console.log(typeof remaining);

Résultat

7
7
number

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.

Sources