Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Bitowy operator OR (|)

Operator | łączy bity dwóch wartości: bit wyniku ma wartość 1, jeśli przynajmniej jeden odpowiadający mu bit argumentów wynosi 1. Obsługuje Number i BigInt, ale nie pozwala mieszać tych typów.

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

Składnia

left | right

Operator left | right wykonuje bitową alternatywę: 0 | 0 daje 0, a każda inna para bitów daje 1. Przydaje się do łączenia flag, którym przypisano oddzielne bity. W przykładzie READ | WRITE łączy 001 i 010, dając 011, czyli 3.

Argumenty są przekształcane do wartości numerycznych. Dla Number oba są następnie konwertowane do 32-bitowych liczb całkowitych ze znakiem; wynik nadal ma typ Number. Część ułamkowa jest odrzucana w kierunku zera, a wartość zawija się modulo 2 ** 32 i jest interpretowana ze znakiem. Dlatego 2147483648 | 0 daje -2147483648. Wartości NaN, Infinity i -Infinity są konwertowane do zera. Zapis x | 0 nie jest bezpiecznym sposobem obcinania dowolnych liczb.

Dla dwóch wartości BigInt wynik jest typu BigInt, bez ograniczenia do 32 bitów. Liczby ujemne zachowują się jak zapis uzupełnień do dwóch z nieskończonym rozszerzeniem znaku. Jeśli po konwersji jeden argument ma typ Number, a drugi BigInt, zgłaszany jest TypeError; przykładem jest 1n | 1.

Nie myl | z logicznym ||: | nie stosuje krótkiego spięcia i daje wynik numeryczny, a || może pominąć prawy argument i zwraca jeden z argumentów. Operator | ma niższy priorytet niż &, ^ i porównania równości; stosuj nawiasy, np. (permissions | READ) === permissions.

Przykłady

const READ = 0b001;
const WRITE = 0b010;
const permissions = READ | WRITE;
console.log(permissions);
console.log(permissions.toString(2));
console.log(2147483648 | 0);
console.log(String(5n | 3n));

Wynik

3
11
-2147483648
7

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła