Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Bitové OR s priradením (|=)

Operátor |= vykoná bitové OR medzi aktuálnou hodnotou cieľa a pravým operandom a výsledok priradí cieľu. Umožňuje nastaviť bity vybrané maskou bez vynulovania ostatných; podporuje Number aj BigInt.

Verzia: 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 vypočíta bitové OR (|) aktuálnej hodnoty cieľa a pravého operandu a výsledok priradí cieľu. Ak priradenie prebehne bez chyby, hodnotou výrazu je vypočítaný výsledok bitového OR. Setter vlastnosti môže skončiť bez chyby aj bez toho, aby odovzdanú hodnotu uložil. Aj vtedy je hodnotou výrazu vypočítaný výsledok. Bit výsledku je 1, ak je 1 aspoň jeden z príslušných bitov operandov. Typickým použitím je zapínanie príznakov pomocou masky.

Pri jednoduchej premennej sa flags |= mask správa ako flags = flags | mask, výraz určujúci cieľ sa však vyhodnotí iba raz. Je to dôležité pri prístupe k vlastnostiam s vedľajšími účinkami. Mimo striktného režimu môže priradenie pomocou |= do nezapisovateľnej dátovej vlastnosti prebehnúť bez chyby: vlastnosť zostane nezmenená a hodnotou výrazu je vypočítaný výsledok bitového OR. V striktnom režime takýto pokus o zápis vyvolá TypeError. Pokus o zmenu premennej deklarovanej pomocou const vyvolá TypeError v oboch režimoch.

Operandy sa prevedú na číselný typ. Pri Number ich operácia prevedie na 32-bitové celé čísla so znamienkom: zahodí zlomkovú časť a zachová dolných 32 bitov. Výsledok je tiež 32-bitové celé číslo so znamienkom, takže môže byť záporný. Pri BigInt sa limit 32 bitov neuplatňuje. Po prevode musia mať oba operandy rovnaký číselný typ; kombinácia Number a BigInt vyvolá TypeError.

Nezamieňajte |= s logickým OR priradením (||=). |= nevykonáva skrátené vyhodnotenie podľa pravdivostnej hodnoty ľavej strany; pri bežnom priebehu sa vyhodnotí pravý operand a vykoná sa priradenie. V príklade má výraz 0b0001 | 0b0100 hodnotu 0b0101, teda 5. Opätovné použitie tej istej masky ponechá tieto bity zapnuté.

Príklady

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

Výsledok

5
5
5

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje