База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Побитово OR с присвояване (|=)

Операторът |= изпълнява побитово OR между текущата стойност на целта и десния операнд, след което присвоява резултата на целта. Позволява да задавате битовете, избрани чрез маска, без да изчиствате останалите; поддържа Number и BigInt.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

target |= expression

target |= expression изчислява побитовото OR (|) на текущата стойност на целта и десния операнд, след което присвоява резултата на целта. Ако присвояването завърши нормално, стойността на израза е изчисленият резултат от побитовото OR. Сетерът на свойство може да завърши нормално, без да запише получената стойност. И в този случай стойността на израза е изчисленият резултат. Бит в резултата е 1, ако поне един от съответните битове на операндите е 1. Типична употреба е включването на флагове с маска.

При обикновена променлива flags |= mask се държи като flags = flags | mask, но изразът, който определя целта, се изчислява само веднъж. Това е важно при достъп до свойства със странични ефекти. Извън строг режим присвояването с |= на свойство за данни, което не позволява запис, може да завърши нормално: свойството остава непроменено, а стойността на израза е изчисленият резултат от побитовото OR. В строг режим такъв опит за запис предизвиква TypeError. Опитът за промяна на променлива, декларирана с const, предизвиква TypeError и в двата режима.

Операндите се преобразуват числово. При Number операцията ги преобразува в знакови 32-битови цели числа: отхвърля дробните части и запазва долните 32 бита. Резултатът също е знаково 32-битово цяло число и затова може да е отрицателен. При BigInt няма ограничение до 32 бита. След преобразуването двата операнда трябва да са от един и същ числов тип; комбинирането на Number и BigInt предизвиква TypeError.

Не бъркайте |= с логическото OR присвояване (||=). |= не пропуска изчисляването на десния операнд според това дали лявата стойност се счита за истина или лъжа: при нормално протичане десният операнд се изчислява и присвояването се изпълнява. В примера 0b0001 | 0b0100 дава 0b0101, или 5. Повторното прилагане на същата маска оставя тези битове включени.

Примери

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

Резултат

5
5
5

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници