CKTIS / JavaScript
Opérateur de reste (%)
L’opérateur % calcule un reste pour des valeurs Number ou BigInt. Un résultat non nul porte le signe du dividende ; avec des nombres négatifs, le reste diffère donc du modulo non négatif. Les types des opérandes et la division par zéro demandent une attention particulière.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
dividend % divisorDans dividend % divisor, l’opérande de gauche est le dividende et celui de droite est le diviseur. Pour des valeurs finies et un diviseur non nul, le reste correspond à la soustraction, au dividende, du diviseur multiplié par le quotient tronqué vers zéro. Un résultat non nul porte le signe du dividende : -13 % 5 vaut -3, tandis que 13 % -5 vaut 3. % ne signifie pas « pourcentage ».
Le reste n’est pas équivalent au modulo non négatif. Pour des valeurs Number entières dans la plage sûre et un diviseur positif, on peut normaliser avec ((dividend % divisor) + divisor) % divisor ; il faut aussi tenir compte de la plage sûre de la somme intermédiaire. Pour -13 et 5, le résultat est 2.
Les opérandes sont convertis en valeurs numériques ; après conversion, ils doivent être tous deux de type Number ou tous deux de type BigInt. Mélanger ces types déclenche une TypeError. Number accepte les fractions : par exemple, 5.5 % 2 vaut 1.5, mais la précision en virgule flottante impose des limites. BigInt opère sur des entiers.
Avec Number, un diviseur égal à 0 ou -0, un opérande NaN ou un dividende infini produit NaN. Un dividende fini avec un diviseur infini reste inchangé. Un dividende négatif peut produire -0, détectable avec Object.is(result, -0). Avec BigInt, un diviseur égal à 0n déclenche une RangeError ; ce type ne possède pas de -0.
% a la même priorité que * et /, supérieure à celle de + et - ; les opérateurs de ce groupe s’associent de gauche à droite. Il fait partie du langage ECMAScript, et non d’une API Web. L’exemple nécessite un environnement prenant en charge BigInt.
Exemples
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));Résultat
-3 2 1.5 3 true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.