CKTIS / JavaScript
Affectation par décalage à gauche (<<=)
L’opérateur `<<=` décale les bits d’une valeur vers la gauche et affecte le résultat à la cible. La valeur stockée dans la cible peut différer du résultat du décalage. Le décalage s’effectue sur 32 bits pour `Number`, mais le résultat n’est pas tronqué à 32 bits pour `BigInt`.
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 <<= shiftCounttarget <<= shiftCount lit la valeur de la cible, effectue le décalage <<, puis affecte le résultat à la cible. L’expression renvoie le résultat du décalage, même si cette valeur est convertie lors de l’écriture dans la cible. Par exemple, si un élément d’un Uint8Array contient 128, un décalage d’un bit vers la gauche avec <<= donne 256 comme valeur de l’expression, mais l’élément reçoit 0. Cette expression ressemble à target = target << shiftCount, mais le membre de gauche n’est évalué qu’une seule fois, ce qui compte notamment pour les accès à des propriétés ayant des effets de bord. La cible doit pouvoir recevoir une affectation ; une variable déclarée avec const ne peut pas être modifiée ainsi.
Pour Number, la valeur de gauche est convertie en entier signé de 32 bits. Le compteur est converti en entier non signé de 32 bits, puis réduit modulo 32. Des zéros entrent par la droite et les bits décalés au-delà des 32 positions sont supprimés. Un décalage de 32 équivaut donc à un décalage de 0, et le résultat peut être négatif. Ce n’est pas un remplacement général de la multiplication par une puissance de deux.
Après conversion numérique, les deux opérandes doivent être de type Number ou tous deux de type BigInt ; mélanger ces types déclenche une TypeError. Avec BigInt, il n’y a ni troncature à 32 bits ni réduction du compteur modulo 32, et un compteur négatif signifie un décalage vers la droite.
Dans l’exemple, décaler 3 de 2 produit 12 ; result reçoit cette même valeur. Le cas wrapped illustre la réduction du compteur modulo 32, tandis que wide montre l’absence de troncature à 32 bits pour BigInt.
Exemples
let mask = 3;
const result = (mask <<= 2);
console.log(mask, result);
let wrapped = 1;
wrapped <<= 32;
console.log(wrapped);
let wide = 1n;
wide <<= 32n;
console.log(String(wide));Résultat
12 12 1 4294967296
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.