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

CKTIS / JavaScript

Atribuição AND bit a bit (&=)

O operador &= calcula o AND bit a bit entre o valor atual do destino e o operando à direita e, em seguida, guarda o resultado nesse mesmo destino. É útil para manter apenas os bits selecionados por uma máscara. Suporta Number e BigInt, mas não uma mistura dos dois.

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 mantém um bit a 1 apenas quando ambos os bits correspondentes são 1. Guarda o resultado em target; a própria expressão de atribuição também resulta nesse valor. Para uma variável simples, x &= mask produz o mesmo resultado que x = x & mask.

Uma diferença importante diz respeito à avaliação do destino: em object[key()] &= mask, a referência do lado esquerdo é avaliada apenas uma vez. Primeiro, é lido o seu valor anterior e, depois, é avaliado o lado direito. Não se trata da atribuição lógica &&=: &= não usa avaliação de curto-circuito nem ignora o lado direito apenas porque o valor do lado esquerdo é 0.

Os operandos são convertidos em valores numéricos. Para Number, a operação usa inteiros com sinal de 32 bits: as partes fracionárias são eliminadas e os bits para além dos 32 bits perdem-se. Para BigInt, esta limitação de largura não se aplica. A mistura de Number e BigInt após a conversão gera um TypeError. O destino tem de permitir escrita; atribuir a uma variável declarada com const gera um TypeError.

No exemplo, a máscara mantém de 0b1101 apenas os bits também presentes em 0b1010, produzindo 0b1000, ou seja, 8. Tanto flags como result têm o valor 8; toString(2) apresenta a representação binária sem prefixo.

Exemplos

let flags = 0b1101;
const mask = 0b1010;
const result = (flags &= mask);
console.log(flags);
console.log(result);
console.log(flags.toString(2));

Resultado

8
8
1000

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