Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Asignación OR bit a bit (|=)

El operador |= realiza un OR bit a bit entre el valor actual del destino y el operando derecho y, a continuación, asigna el resultado al destino. Permite activar los bits seleccionados por una máscara sin borrar los demás y admite Number y BigInt.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

target |= expression

target |= expression calcula el OR bit a bit (|) del valor actual del destino y el operando derecho, y luego asigna el resultado al destino. Si la asignación termina con normalidad, el valor de la expresión es el resultado del OR bit a bit. El setter de una propiedad puede terminar con normalidad sin guardar el valor recibido; aun así, la expresión toma el valor calculado. Cada bit del resultado es 1 si al menos uno de los bits correspondientes de los operandos es 1. Un uso habitual es activar indicadores con una máscara.

Para una variable simple, flags |= mask se comporta como flags = flags | mask, pero la expresión que identifica el destino solo se evalúa una vez. Esto es importante al acceder a propiedades con efectos secundarios. Fuera del modo estricto, una asignación con |= a una propiedad de datos no escribible puede terminar con normalidad: la propiedad no cambia y el valor de la expresión es el resultado calculado del OR bit a bit. En modo estricto, ese intento de escritura provoca un TypeError. Intentar modificar una variable declarada con const provoca un TypeError en ambos modos.

Los operandos se someten a una conversión numérica. Para Number, la operación los convierte en enteros con signo de 32 bits: descarta las partes fraccionarias y conserva los 32 bits inferiores. El resultado también es un entero con signo de 32 bits, por lo que puede ser negativo. Para BigInt no existe el límite de 32 bits. Tras la conversión, ambos operandos deben tener el mismo tipo numérico; combinar Number y BigInt provoca un TypeError.

No confundas |= con la asignación OR lógica (||=). |= no aplica cortocircuito en función de si el valor izquierdo se considera verdadero o falso; durante la evaluación normal, evalúa el operando derecho y realiza la asignación. En el ejemplo, 0b0001 | 0b0100 produce 0b0101, es decir, 5. Aplicar de nuevo la misma máscara mantiene esos bits activados.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes