CKTIS / JavaScript
Operador resto (%)
O operador % calcula o resto para valores Number ou BigInt. Um resultado diferente de zero tem o sinal do dividendo, pelo que, com números negativos, o resto difere do módulo não negativo. É necessário ter atenção aos tipos dos operandos e à divisão por zero.
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
dividend % divisorEm dividend % divisor, o operando à esquerda é o dividendo e o da direita é o divisor. Para valores finitos e um divisor diferente de zero, o resto corresponde a subtrair ao dividendo o divisor multiplicado pelo quociente truncado em direção a zero. Um resultado diferente de zero tem o sinal do dividendo: -13 % 5 dá -3, enquanto 13 % -5 dá 3. % não significa percentagem.
O resto não é o mesmo que o módulo não negativo. Para valores Number inteiros dentro do intervalo seguro e um divisor positivo, é possível normalizar com ((dividend % divisor) + divisor) % divisor; é também necessário ter em conta o intervalo seguro da soma intermédia. Para -13 e 5, o resultado é 2.
Os operandos são convertidos em valores numéricos; depois da conversão, têm de ser ambos do tipo Number ou ambos do tipo BigInt. Misturar estes tipos lança um TypeError. Number permite frações: por exemplo, 5.5 % 2 dá 1.5, mas está sujeito às limitações de precisão de vírgula flutuante. BigInt opera sobre números inteiros.
Para Number, um divisor 0 ou -0, um operando NaN ou um dividendo infinito produz NaN. Um dividendo finito com um divisor infinito permanece inalterado. Um dividendo negativo pode produzir -0, detetável com Object.is(result, -0). Para BigInt, um divisor 0n lança um RangeError; este tipo não tem -0.
% tem a mesma precedência que * e /, superior à de + e -; os operadores deste grupo associam da esquerda para a direita. Faz parte da linguagem ECMAScript, não de uma API Web. O exemplo requer um ambiente compatível com BigInt.
Exemplos
const dividend = -13;
const divisor = 5;
console.log(dividend % divisor);
console.log(((dividend % divisor) + divisor) % divisor);
console.log(5.5 % 2);
console.log(String(13n % 5n));
console.log(Object.is(-10 % 5, -0));
console.log(Number.isNaN(10 % 0));Resultado
-3 2 1.5 3 true true
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.