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

CKTIS / JavaScript

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

O operador **= eleva o valor atual de um alvo a uma potência indicada e guarda o resultado na mesma localização. O alvo é avaliado apenas uma vez. 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 **= exponent

target **= exponent lê o valor do alvo, calcula a potência com ** e escreve o resultado de volta. A expressão completa devolve o valor atribuído. Para uma variável simples, x **= y comporta-se como x = x ** y, mas a expressão que identifica o alvo é avaliada apenas uma vez.

Isto é importante quando existem efeitos secundários: em values[index++] **= 2, index é incrementado apenas uma vez. O valor atual do alvo é lido antes de o lado direito ser avaliado. O alvo tem de permitir atribuição; tentar alterar uma variável declarada com const lança um TypeError.

Os operandos são submetidos a conversão numérica. Após a conversão, ambos têm de ser do tipo Number ou ambos do tipo BigInt; misturar estes tipos lança um TypeError. Um expoente BigInt negativo lança um RangeError. Os cálculos com Number estão sujeitos aos limites de precisão de vírgula flutuante.

No exemplo, o elemento do array muda de 3 para 9, index vale 1 e result vale 9. Depois, 2n elevado a 5n produz 32n; String(base) garante que é impresso 32 sem o sufixo n.

Exemplos

const values = [3];
let index = 0;
const result = (values[index++] **= 2);
console.log(values[0], index, result);

let base = 2n;
base **= 5n;
console.log(String(base));

Resultado

9 1 9
32

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