CKTIS / JavaScript
Przypisanie z mnożeniem (*=)
Operator *= mnoży bieżącą wartość zmiennej lub właściwości przez prawy operand i przypisuje obliczony iloczyn. Wartością wyrażenia jest ten iloczyn, niekoniecznie wartość zapisana w celu. Operator obsługuje Number oraz BigInt, ale nie pozwala mieszać tych typów.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
target *= expressiontarget *= expression odczytuje wartość celu, oblicza prawy operand, wykonuje mnożenie i przypisuje obliczony iloczyn do tego samego celu. Wartością całego wyrażenia jest obliczony iloczyn: operator nie odczytuje ponownie wartości celu po przypisaniu. Na przykład jeśli items jest tablicą typu Uint8Array, a items[0] ma wartość 200, to wartością wyrażenia items[0] *= 2 jest 400, lecz w elemencie zostaje zapisana wartość 144. Cel musi być poprawnym miejscem przypisania, np. zmienną lub właściwością obiektu; przypisanie do zmiennej zadeklarowanej przez const zgłasza TypeError.
Dla zwykłej zmiennej x *= y działa jak x = x * y, ale ogólnie nie jest to bezpieczne przepisanie: lewa strona *= jest obliczana tylko raz. Ma to znaczenie przy wywołaniach funkcji lub indeksach z efektami ubocznymi, np. items[i++] *= 2 zwiększa i tylko raz.
Mnożenie stosuje konwersję numeryczną: "5" pomnożone przez 3 daje liczbę 15, a nie powtórzony tekst. Operandy po konwersji muszą być oba typu Number albo oba typu BigInt; mieszanie tych typów zgłasza TypeError. Wynik typu Number może podlegać zaokrągleniu lub być NaN.
Przykład pokazuje zapis wyniku, wartość wyrażenia przypisania, konwersję tekstu na liczbę i mnożenie BigInt. String(count) zapewnia wypisanie 14 bez zależnego od konsoli formatowania BigInt.
Przykłady
let total = 6;
const result = (total *= 4);
console.log(total, result);
let amount = "5";
amount *= 3;
console.log(amount, typeof amount);
let count = 7n;
count *= 2n;
console.log(String(count));Wynik
24 24 15 number 14
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.