Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 |= expression

target |= 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.

Fontes