Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Przypisanie z bitowym OR (|=)

Operator |= wykonuje bitowe OR na bieżącej wartości celu i prawym operandzie, a następnie wykonuje przypisanie obliczonego wyniku do celu. Pozwala ustawiać bity wskazane przez maskę bez zerowania pozostałych; obsługuje Number i BigInt.

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

target |= expression

target |= expression oblicza bitowe OR (|) bieżącej wartości celu i prawego operandu, a następnie wykonuje przypisanie wyniku do celu. Jeśli przypisanie kończy się bez błędu, wartością całego wyrażenia jest obliczony wynik OR. Setter właściwości może zakończyć działanie bez błędu i nie zapisać przekazanej wartości; wyrażenie nadal ma wartość obliczonego wyniku OR. Bit wyniku ma wartość 1, jeśli przynajmniej jeden z odpowiadających mu bitów operandów ma wartość 1. Typowym zastosowaniem jest włączanie flag za pomocą maski.

Dla prostej zmiennej flags |= mask działa jak flags = flags | mask, ale wyrażenie wskazujące cel jest obliczane tylko raz. Ma to znaczenie przy dostępie do właściwości z efektami ubocznymi. Poza trybem ścisłym przypisanie przez |= do niezapisywalnej właściwości danych może zakończyć się bez błędu: właściwość pozostaje niezmieniona, a wartością wyrażenia jest obliczony wynik OR. W trybie ścisłym taka próba zapisu powoduje TypeError. Próba zmiany zmiennej zadeklarowanej przez const powoduje TypeError w obu trybach.

Operandy podlegają konwersji numerycznej. Dla Number operacja przekształca je do 32-bitowych liczb całkowitych ze znakiem: odrzuca część ułamkową i zachowuje dolne 32 bity. Wynik również jest 32-bitową liczbą całkowitą ze znakiem, więc może być ujemny. Dla BigInt nie ma ograniczenia do 32 bitów. Po konwersji oba operandy muszą mieć ten sam typ numeryczny; połączenie Number i BigInt powoduje TypeError.

Nie myl |= z logicznym przypisaniem OR (||=). |= nie stosuje krótkiego spięcia na podstawie prawdziwości lewej wartości; przy normalnym przebiegu oblicza prawy operand i wykonuje przypisanie wyniku. W przykładzie 0b0001 | 0b0100 daje 0b0101, czyli 5. Ponowne zastosowanie tej samej maski pozostawia te bity ustawione.

Przykłady

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

Wynik

5
5
5

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

Źródła