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

CKTIS / JavaScript

Affectation avec exponentiation (**=)

L’opérateur **= élève la valeur actuelle d’une cible à une puissance donnée et enregistre le résultat au même emplacement. La cible n’est évaluée qu’une seule fois. Il prend en charge Number et 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

target **= exponent

target **= exponent lit la valeur de la cible, calcule la puissance avec **, puis réécrit le résultat. L’expression entière renvoie la valeur affectée. Pour une variable simple, x **= y se comporte comme x = x ** y, mais l’expression qui désigne la cible n’est évaluée qu’une seule fois.

C’est important en présence d’effets de bord : dans values[index++] **= 2, index n’est incrémenté qu’une fois. La valeur actuelle de la cible est lue avant l’évaluation du membre de droite. La cible doit accepter une affectation ; tenter de modifier une variable déclarée avec const déclenche un TypeError.

Les opérandes subissent une conversion numérique. Après conversion, les deux doivent être de type Number ou tous deux de type BigInt ; mélanger ces types déclenche un TypeError. Un exposant BigInt négatif déclenche un RangeError. Les calculs avec Number sont soumis aux limites de précision des nombres à virgule flottante.

Dans l’exemple, l’élément du tableau passe de 3 à 9, index vaut 1 et result vaut 9. Ensuite, 2n élevé à la puissance 5n donne 32n ; String(base) permet d’afficher 32 sans le suffixe n.

Exemples

const values = [3];
let index = 0;
const result = (values[index++] **= 2);
console.log(values[0], index, result);

let base = 2n;
base **= 5n;
console.log(String(base));

Résultat

9 1 9
32

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