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

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

O 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.

Fontes