Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 *= expression

target *= 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.

Źródła