Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Atribuição com multiplicação (*=)

O operador *= multiplica o valor atual de uma variável ou propriedade pelo operando à direita e atribui-lhe o produto calculado. A expressão devolve esse produto, que pode ser diferente do valor efetivamente guardado. O operador suporta Number e BigInt, mas não permite misturar estes tipos.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

target *= expression

target *= expression lê o valor do destino, avalia o operando à direita, efetua a multiplicação e atribui o produto calculado ao mesmo destino. O valor da expressão completa é o produto calculado: o operador não volta a ler o valor do destino depois da atribuição. Por exemplo, se items for um Uint8Array e items[0] tiver o valor 200, a expressão items[0] *= 2 tem o valor 400, mas o elemento fica com o valor 144. O destino tem de ser um local de atribuição válido, como uma variável ou propriedade de um objeto; atribuir a uma variável declarada com const lança TypeError.

Para uma variável simples, x *= y comporta-se como x = x * y, mas esta não é uma reescrita segura em geral: o lado esquerdo de *= é avaliado apenas uma vez. Isto é importante com chamadas de funções ou índices com efeitos secundários; por exemplo, items[i++] *= 2 incrementa i apenas uma vez.

A multiplicação aplica uma conversão numérica: "5" multiplicado por 3 produz o número 15, e não texto repetido. Depois da conversão, ambos os operandos têm de ser do tipo Number ou ambos do tipo BigInt; misturar estes tipos lança TypeError. Um resultado Number pode envolver arredondamento ou ser NaN.

O exemplo demonstra o armazenamento do resultado, o valor da expressão de atribuição, a conversão de texto em número e a multiplicação de BigInt. String(count) garante que 14 é apresentado sem depender da formatação de BigInt da consola.

Exemplos

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));

Resultado

24 24
15 number
14

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes