CKTIS / JavaScript
Operador resto (%)
El operador % calcula el resto para valores Number o BigInt. Un resultado distinto de cero tiene el signo del dividendo, así que con números negativos el resto se distingue del módulo no negativo. Hay que prestar atención a los tipos de los operandos y a la división por cero.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
dividend % divisorEn dividend % divisor, el operando de la izquierda es el dividendo y el de la derecha, el divisor. Para valores finitos y un divisor distinto de cero, el resto corresponde a restar del dividendo el divisor multiplicado por el cociente truncado hacia cero. Un resultado distinto de cero tiene el signo del dividendo: -13 % 5 da -3, mientras que 13 % -5 da 3. % no significa porcentaje.
El resto no es lo mismo que el módulo no negativo. Para valores Number enteros dentro del rango seguro y un divisor positivo, se puede normalizar con ((dividend % divisor) + divisor) % divisor; también hay que tener en cuenta el rango seguro de la suma intermedia. Para -13 y 5, el resultado es 2.
Los operandos se convierten en valores numéricos; después de la conversión, ambos deben ser Number o ambos BigInt. Mezclar estos tipos lanza un TypeError. Number permite fracciones: por ejemplo, 5.5 % 2 da 1.5, pero está sujeto a las limitaciones de precisión de coma flotante. BigInt opera con enteros.
Para Number, un divisor 0 o -0, un operando NaN o un dividendo infinito produce NaN. Un dividendo finito con un divisor infinito permanece sin cambios. Un dividendo negativo puede producir -0, que se puede detectar con Object.is(result, -0). Para BigInt, un divisor 0n lanza un RangeError; este tipo no tiene -0.
% tiene la misma precedencia que * y /, y mayor que + y -; los operadores de este grupo se asocian de izquierda a derecha. Forma parte del lenguaje ECMAScript, no de una API Web. El ejemplo requiere un entorno compatible con BigInt.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.