CKTIS / JavaScript
Atribuição do resto (%=)
O operador %= calcula o resto da divisão do valor atual pelo operando à direita e guarda o resultado no mesmo destino. Suporta Number e BigInt; o resto não é o mesmo que um módulo sempre não negativo.
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 %= expressionO operador target %= expression lê o valor do destino, calcula o resto da divisão pelo operando à direita e atribui o resultado ao destino. A própria expressão devolve o valor atribuído. Para uma variável simples, x %= y funciona como x = x % y, mas o destino à esquerda só é avaliado uma vez — o que é importante no acesso a propriedades com efeitos secundários.
% significa resto, não um módulo sempre não negativo: -17 % 5 resulta em -2. Um resto diferente de zero tem o sinal do dividendo. Com Number, o resultado também pode ser -0; um divisor igual a zero produz NaN.
Os operandos são convertidos em valores numéricos; no final, ambos têm de ser do tipo Number ou ambos do tipo BigInt. A mistura destes tipos gera TypeError. Se ambos os operandos forem do tipo BigInt, um divisor igual a 0n gera RangeError. O destino tem de permitir escrita: atribuir a uma variável declarada com const gera TypeError.
O exemplo demonstra restos positivo e negativo e a variante BigInt. String(large) garante uma formatação consistente do resultado, independentemente da forma como a consola apresenta valores BigInt.
Exemplos
let value = 17;
value %= 5;
console.log(value);
let negative = -17;
negative %= 5;
console.log(negative);
let large = 17n;
large %= 5n;
console.log(String(large));Resultado
2 -2 2
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.