CKTIS / JavaScript
Affectation avec OU bit à bit (|=)
L’opérateur |= effectue un OU bit à bit entre la valeur actuelle de la cible et l’opérande de droite, puis affecte le résultat à la cible. Il permet d’activer les bits sélectionnés par un masque sans effacer les autres et prend en charge Number et 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 |= expressiontarget |= expression calcule le OU bit à bit (|) entre la valeur actuelle de la cible et l’opérande de droite, puis affecte le résultat à la cible. Si l’affectation se termine normalement, la valeur de l’expression est le résultat du OU bit à bit. Le setter d’une propriété peut se terminer normalement sans stocker la valeur reçue ; même dans ce cas, l’expression a pour valeur le résultat calculé. Chaque bit du résultat vaut 1 si au moins un des bits correspondants des opérandes vaut 1. Un usage courant consiste à activer des indicateurs à l’aide d’un masque.
Pour une variable simple, flags |= mask se comporte comme flags = flags | mask, mais l’expression qui désigne la cible n’est évaluée qu’une seule fois. Cela compte lors d’un accès à une propriété qui entraîne des effets de bord. En dehors du mode strict, une affectation avec |= à une propriété de données non modifiable peut se terminer normalement : la propriété reste inchangée et l’expression a pour valeur le résultat calculé du OU bit à bit. En mode strict, cette tentative d’écriture déclenche une TypeError. Tenter de modifier une variable déclarée avec const déclenche une TypeError dans les deux modes.
Les opérandes subissent une conversion numérique. Pour Number, l’opération les convertit en entiers signés sur 32 bits : elle supprime les parties fractionnaires et conserve les 32 bits de poids faible. Le résultat est aussi un entier signé sur 32 bits et peut donc être négatif. Pour BigInt, il n’y a pas de limite à 32 bits. Après conversion, les deux opérandes doivent avoir le même type numérique ; combiner Number et BigInt déclenche une TypeError.
Ne confondez pas |= avec l’affectation OU logique (||=). |= n’effectue pas de court-circuit selon la valeur de vérité de la partie gauche : lorsque l’évaluation se déroule normalement, l’opérande de droite est évalué et l’affectation est effectuée. Dans l’exemple, 0b0001 | 0b0100 produit 0b0101, soit 5. Appliquer à nouveau le même masque laisse ces bits activés.
Exemples
let flags = 0b0001;
const mask = 0b0100;
const result = (flags |= mask);
console.log(flags);
console.log(result);
flags |= mask;
console.log(flags);Résultat
5 5 5
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.