WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Bitweises OR mit Zuweisung (|=)

Der Operator |= verknüpft den aktuellen Wert des Ziels und den rechten Operanden mit einem bitweisen OR und weist dem Ziel das berechnete Ergebnis zu. Damit lassen sich die durch eine Maske ausgewählten Bits setzen, ohne andere zu löschen; unterstützt werden Number und BigInt.

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

target |= expression

target |= expression berechnet das bitweise OR (|) aus dem aktuellen Wert des Ziels und dem rechten Operanden und weist dem Ziel das Ergebnis zu. Wird die Zuweisung ohne Fehler abgeschlossen, ist der Wert des Ausdrucks das berechnete OR-Ergebnis. Der Setter einer Eigenschaft kann ohne Fehler zurückkehren, ohne den übergebenen Wert zu speichern. Auch dann ist der Wert des Ausdrucks das berechnete OR-Ergebnis. Ein Ergebnisbit ist 1, wenn mindestens eines der entsprechenden Operandenbits 1 ist. Ein typischer Anwendungsfall ist das Setzen von Flags mithilfe einer Maske.

Bei einer einfachen Variablen verhält sich flags |= mask wie flags = flags | mask, aber der Ausdruck, der das Ziel bestimmt, wird nur einmal ausgewertet. Das ist bei Eigenschaftszugriffen mit Nebenwirkungen wichtig. Außerhalb des Strict Mode kann eine Zuweisung mit |= an eine nicht beschreibbare Dateneigenschaft ohne Fehler enden: Die Eigenschaft bleibt unverändert, und der Ausdruck liefert das berechnete OR-Ergebnis. Im Strict Mode löst ein solcher Schreibversuch einen TypeError aus. Der Versuch, eine mit const deklarierte Variable zu ändern, löst in beiden Modi einen TypeError aus.

Die Operanden werden numerisch konvertiert. Bei Number wandelt die Operation sie in vorzeichenbehaftete 32-Bit-Ganzzahlen um: Nachkommastellen werden verworfen und die unteren 32 Bits beibehalten. Das Ergebnis ist ebenfalls eine vorzeichenbehaftete 32-Bit-Ganzzahl und kann daher negativ sein. Für BigInt gibt es keine 32-Bit-Begrenzung. Nach der Konvertierung müssen beide Operanden denselben numerischen Typ haben; die Kombination von Number und BigInt löst einen TypeError aus.

Verwechsle |= nicht mit der logischen OR-Zuweisung (||=). |= wertet den rechten Operanden unabhängig vom Wahrheitswert der linken Seite aus, sofern die Auswertung normal verläuft, und führt anschließend die Zuweisung aus. Im Beispiel ergibt 0b0001 | 0b0100 den Wert 0b0101, also 5. Wird dieselbe Maske erneut angewendet, bleiben diese Bits gesetzt.

Beispiele

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

Ergebnis

5
5
5

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