KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Bitgewijze OR-toewijzing (|=)

De operator |= voert een bitgewijze OR uit op de huidige waarde van het doel en de rechteroperand en wijst het resultaat vervolgens toe aan het doel. Hiermee kun je de door een masker geselecteerde bits instellen zonder de andere te wissen; Number en BigInt worden ondersteund.

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

Syntax

target |= expression

target |= expression berekent de bitgewijze OR (|) van de huidige waarde van het doel en de rechteroperand en wijst het resultaat vervolgens toe aan het doel. Als de toewijzing normaal wordt voltooid, is de waarde van de expressie het berekende OR-resultaat. De setter van een eigenschap kan normaal eindigen zonder de ontvangen waarde op te slaan. Ook dan is de waarde van de expressie het berekende OR-resultaat. Een resultaatbit is 1 als ten minste een van de overeenkomstige bits van de operanden 1 is. Een gebruikelijke toepassing is het inschakelen van vlaggen met een masker.

Voor een eenvoudige variabele werkt flags |= mask hetzelfde als flags = flags | mask, maar de expressie die het doel aanwijst, wordt slechts één keer geëvalueerd. Dat is van belang bij toegang tot eigenschappen met neveneffecten. Buiten de strikte modus kan een toewijzing met |= aan een niet-schrijfbare data-eigenschap zonder fout worden voltooid: de eigenschap blijft ongewijzigd en de expressie levert het berekende OR-resultaat op. In de strikte modus veroorzaakt zo’n schrijfpoging een TypeError. Een poging om een variabele te wijzigen die met const is gedeclareerd, veroorzaakt in beide modi een TypeError.

De operanden worden numeriek geconverteerd. Voor Number converteert de bewerking ze naar 32-bits gehele getallen met teken: de decimale delen worden weggelaten en de laagste 32 bits blijven behouden. Het resultaat is ook een 32-bits geheel getal met teken en kan dus negatief zijn. Voor BigInt geldt geen limiet van 32 bits. Na de conversie moeten beide operanden hetzelfde numerieke type hebben; Number en BigInt combineren veroorzaakt een TypeError.

Verwar |= niet met logische OR-toewijzing (||=). |= slaat de rechteroperand niet over op basis van de waarheidswaarde van de linkeroperand: bij normale evaluatie wordt de rechteroperand geëvalueerd en wordt de toewijzing uitgevoerd. In het voorbeeld levert 0b0001 | 0b0100 0b0101, oftewel 5, op. Als je hetzelfde masker opnieuw toepast, blijven die bits ingeschakeld.

Voorbeelden

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

Resultaat

5
5
5

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen