WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Bitweiser ODER-Operator (|)

Der Operator | kombiniert die Bits zweier Werte: Ein Ergebnisbit ist 1, wenn mindestens eines der entsprechenden Operandenbits 1 ist. Er unterstützt Number und BigInt, erlaubt aber keine Mischung dieser Typen.

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

Syntax

left | right

Der Operator left | right führt ein inklusives bitweises ODER aus: 0 | 0 ergibt 0, und jedes andere Bitpaar ergibt 1. Er eignet sich zum Kombinieren von Flags, denen einzelne Bits zugewiesen wurden. Im Beispiel kombiniert READ | WRITE die Werte 001 und 010 zu 011, also 3.

Die Operanden werden in numerische Werte umgewandelt. Bei Number werden beide anschließend in vorzeichenbehaftete 32-Bit-Ganzzahlen konvertiert; das Ergebnis hat weiterhin den Typ Number. Der Nachkommaanteil wird gegen null abgeschnitten, und der Wert wird modulo 2 ** 32 umgebrochen und als vorzeichenbehaftet interpretiert. Daher ergibt 2147483648 | 0 den Wert -2147483648. Die Werte NaN, Infinity und -Infinity werden zu null konvertiert. Der Ausdruck x | 0 ist keine sichere Methode, beliebige Zahlen abzuschneiden.

Bei zwei BigInt-Werten ist das Ergebnis vom Typ BigInt und nicht auf 32 Bit beschränkt. Negative Zahlen verhalten sich wie Zweierkomplementdarstellungen mit unendlicher Vorzeichenerweiterung. Hat nach der Konvertierung ein Operand den Typ Number und der andere BigInt, wird ein TypeError ausgelöst; 1n | 1 ist ein Beispiel dafür.

Verwechsle | nicht mit dem logischen Operator ||: | wertet nicht kurzschließend aus und liefert ein numerisches Ergebnis, während || den rechten Operanden überspringen kann und einen seiner Operanden zurückgibt. Der Operator | hat eine niedrigere Priorität als &, ^ und Gleichheitsvergleiche; verwende Klammern, zum Beispiel (permissions | READ) === permissions.

Beispiele

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));

Ergebnis

3
11
-2147483648
7

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen