CKTIS / JavaScript
Zuweisung mit Linksverschiebung (<<=)
Der Operator `<<=` verschiebt die Bits eines Werts nach links und weist das Ergebnis dem Ziel zu. Der im Ziel gespeicherte Wert kann vom Ergebnis der Verschiebung abweichen. Bei `Number` arbeitet die Verschiebung mit 32 Bit; bei `BigInt` wird das Ergebnis nicht auf 32 Bit gekürzt.
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 <<= shiftCounttarget <<= shiftCount liest den Wert des Ziels, führt die Verschiebung << aus und weist das Ergebnis dem Ziel zu. Der Ausdruck ergibt das Ergebnis der Verschiebung, auch wenn der Wert beim Schreiben ins Ziel umgewandelt wird. Enthält etwa ein Element eines Uint8Array den Wert 128, ergibt die Verschiebung um ein Bit nach links mit <<= den Ausdruckswert 256, im Element wird aber 0 gespeichert. Der Ausdruck ähnelt target = target << shiftCount, wertet die linke Seite jedoch nur einmal aus – wichtig etwa beim Zugriff auf Eigenschaften mit Seiteneffekten. Das Ziel muss beschreibbar sein; eine mit const deklarierte Variable lässt sich so nicht ändern.
Bei Number wird der linke Wert in eine vorzeichenbehaftete 32-Bit-Ganzzahl umgewandelt. Der Zähler wird in eine vorzeichenlose 32-Bit-Ganzzahl umgewandelt und anschließend modulo 32 reduziert. Von rechts rücken Nullen nach, und Bits, die über die 32 Positionen hinausgeschoben werden, gehen verloren. Eine Verschiebung um 32 wirkt daher wie eine Verschiebung um 0, und das Ergebnis kann negativ sein. Dies ist kein allgemeiner Ersatz für die Multiplikation mit einer Zweierpotenz.
Nach der numerischen Konvertierung müssen beide Operanden entweder Number oder beide BigInt sein; eine Mischung dieser Typen löst einen TypeError aus. Bei BigInt gibt es weder eine Kürzung auf 32 Bit noch eine Reduktion des Zählers modulo 32; ein negativer Zähler bedeutet eine Verschiebung nach rechts.
Im Beispiel ergibt die Verschiebung von 3 um 2 den Wert 12; result erhält denselben Wert. Der Fall wrapped veranschaulicht die Reduktion des Zählers modulo 32, während wide zeigt, dass BigInt nicht auf 32 Bit gekürzt wird.
Beispiele
let mask = 3;
const result = (mask <<= 2);
console.log(mask, result);
let wrapped = 1;
wrapped <<= 32;
console.log(wrapped);
let wide = 1n;
wide <<= 32n;
console.log(String(wide));Ergebnis
12 12 1 4294967296
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.