CKTIS / JavaScript
Atribuição OR bit a bit (|=)
O operador |= efetua um OR bit a bit entre o valor atual do destino e o operando à direita e, em seguida, atribui o resultado ao destino. Permite ativar os bits selecionados por uma máscara sem limpar os restantes e suporta Number e BigInt.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
target |= expressiontarget |= expression calcula o OR bit a bit (|) entre o valor atual do destino e o operando à direita e, em seguida, atribui o resultado ao destino. Se a atribuição terminar normalmente, o valor da expressão é o resultado do OR bit a bit. O setter de uma propriedade pode terminar normalmente sem guardar o valor recebido; mesmo nesse caso, o valor da expressão é o resultado calculado. Cada bit do resultado é 1 se pelo menos um dos bits correspondentes dos operandos for 1. Uma utilização comum é ativar sinalizadores com uma máscara.
Para uma variável simples, flags |= mask comporta-se como flags = flags | mask, mas a expressão que identifica o destino só é avaliada uma vez. Isto é importante no acesso a propriedades com efeitos secundários. Fora do modo estrito, uma atribuição com |= a uma propriedade de dados que não permite escrita pode terminar normalmente: a propriedade mantém-se inalterada e o valor da expressão é o resultado calculado do OR bit a bit. Em modo estrito, essa tentativa de escrita provoca um TypeError. Tentar alterar uma variável declarada com const provoca um TypeError em ambos os modos.
Os operandos são sujeitos a conversão numérica. Para Number, a operação converte-os em números inteiros com sinal de 32 bits: descarta as partes fracionárias e conserva os 32 bits menos significativos. O resultado também é um número inteiro com sinal de 32 bits e pode, por isso, ser negativo. Para BigInt, não existe limite de 32 bits. Após a conversão, os dois operandos têm de ter o mesmo tipo numérico; combinar Number e BigInt provoca um TypeError.
Não confundas |= com a atribuição OR lógica (||=). |= não faz curto-circuito consoante o valor à esquerda seja considerado verdadeiro ou falso; durante a avaliação normal, avalia o operando à direita e efetua a atribuição. No exemplo, 0b0001 | 0b0100 produz 0b0101, ou seja, 5. Aplicar novamente a mesma máscara mantém esses bits ativados.
Exemplos
let flags = 0b0001;
const mask = 0b0100;
const result = (flags |= mask);
console.log(flags);
console.log(result);
flags |= mask;
console.log(flags);Resultado
5 5 5
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.