Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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 % divisor

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

Sources