Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Assegnazione OR bit a bit (|=)

L’operatore |= esegue un OR bit a bit tra il valore corrente del target e l’operando destro, quindi assegna il risultato al target. Consente di impostare i bit selezionati da una maschera senza azzerare gli altri e supporta Number e BigInt.

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

Sintassi

target |= expression

target |= expression calcola l’OR bit a bit (|) tra il valore corrente del target e l’operando destro, quindi assegna il risultato al target. Se l’assegnazione si conclude normalmente, il valore dell’espressione è il risultato dell’OR bit a bit. Il setter di una proprietà può terminare normalmente senza memorizzare il valore ricevuto; anche in questo caso, il valore dell’espressione è il risultato calcolato. Ogni bit del risultato è 1 se almeno uno dei bit corrispondenti degli operandi è 1. Un uso tipico consiste nell’attivare flag con una maschera.

Per una variabile semplice, flags |= mask si comporta come flags = flags | mask, ma l’espressione che individua il target viene valutata una sola volta. Questo è importante quando si accede a proprietà con effetti collaterali. Al di fuori della modalità strict, un’assegnazione con |= a una proprietà dati non scrivibile può concludersi normalmente: la proprietà resta invariata e il valore dell’espressione è il risultato calcolato dell’OR bit a bit. In modalità strict, questo tentativo di scrittura genera un TypeError. Tentare di modificare una variabile dichiarata con const genera un TypeError in entrambe le modalità.

Gli operandi vengono sottoposti a conversione numerica. Per Number, l’operazione li converte in interi con segno a 32 bit: scarta le parti frazionarie e conserva i 32 bit meno significativi. Anche il risultato è un intero con segno a 32 bit e può quindi essere negativo. Per BigInt non esiste un limite di 32 bit. Dopo la conversione, entrambi gli operandi devono avere lo stesso tipo numerico; combinare Number e BigInt genera un TypeError.

Non confondere |= con l’assegnazione OR logica (||=). |= non applica la valutazione a cortocircuito in base al valore di verità del lato sinistro: se la valutazione procede normalmente, valuta l’operando destro ed esegue l’assegnazione. Nell’esempio, 0b0001 | 0b0100 produce 0b0101, cioè 5. Applicando di nuovo la stessa maschera, quei bit restano attivi.

Esempi

let flags = 0b0001;
const mask = 0b0100;
const result = (flags |= mask);
console.log(flags);
console.log(result);
flags |= mask;
console.log(flags);

Risultato

5
5
5

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti