CKTIS / JavaScript
Bitweise XOR-Zuweisung (^=)
Der Operator ^= berechnet das bitweise exklusive Oder aus dem aktuellen Wert des Ziels und dem rechten Operanden und weist das Ergebnis anschließend demselben Ziel zu. Damit lassen sich etwa Bits mithilfe einer Maske umschalten. Der Operator 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
target ^= expressiontarget ^= expression führt ein bitweises XOR aus und weist das Ergebnis target zu. Ein Ergebnisbit ist 1, wenn sich die entsprechenden Operandenbits unterscheiden, und 0, wenn sie gleich sind. Eine Maske schaltet daher die durch 1 markierten Bits um und lässt die übrigen unverändert. Dies ist weder Potenzierung noch ein logischer Operator, der mit Wahrheitswerten arbeitet.
Bei einer einfachen Variablen liefert x ^= y dasselbe Ergebnis wie x = x ^ y, wertet die linke Seite aber nur einmal aus. Das ist bei Eigenschaftszugriffen mit Seiteneffekten wichtig. Der aktuelle Zielwert wird gelesen, bevor die rechte Seite ausgewertet wird. Der Zuweisungsausdruck gibt das berechnete XOR-Ergebnis zurück, auch wenn ein Setter den Wert entgegennimmt, ohne ihn zu speichern. Das kann auch ohne Setter passieren: Außerhalb des strikten Modus wird ein Schreibversuch auf eine nicht schreibbare Dateneigenschaft ignoriert, der Ausdruck liefert aber trotzdem das XOR-Ergebnis. Im strikten Modus löst dieser Schreibversuch einen TypeError aus.
Die Operanden werden in numerische Werte umgewandelt. Bei Number arbeitet XOR mit vorzeichenbehafteten 32-Bit-Ganzzahlen: Nachkommastellen werden verworfen und Werte außerhalb des Bereichs auf 32 Bit umgebrochen. Bei BigInt gibt es keine 32-Bit-Beschränkung. Nach der Umwandlung müssen beide Operanden denselben numerischen Typ haben; eine Kombination aus Number und BigInt löst einen TypeError aus.
Im Beispiel ergibt 0b1010 XOR 0b0110 den Wert 0b1100, also 12. Mit derselben Maske wird anschließend wieder 10 hergestellt. Der BigInt-Teil ergibt denselben Zahlenwert, während String(wide) für eine eindeutige Textausgabe sorgt.
Beispiele
let flags = 0b1010;
const mask = 0b0110;
console.log(flags ^= mask);
console.log(flags ^= mask);
let wide = 10n;
wide ^= 6n;
console.log(String(wide));Ergebnis
12 10 12
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.