CKTIS / JavaScript
Affectation du reste (%=)
L’opérateur %= calcule le reste de la valeur actuelle divisée par l’opérande de droite et stocke le résultat dans la même cible. Il prend en charge Number et BigInt ; le reste n’est pas la même chose qu’un modulo toujours non négatif.
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
target %= expressionL’opérateur target %= expression lit la valeur de la cible, calcule le reste de la division par l’opérande de droite, puis affecte le résultat à la cible. L’expression elle-même renvoie la valeur affectée. Pour une variable simple, x %= y fonctionne comme x = x % y, mais la cible à gauche n’est évaluée qu’une seule fois — ce qui est important pour l’accès à une propriété ayant des effets de bord.
% désigne le reste, et non un modulo toujours non négatif : -17 % 5 donne -2. Un reste non nul a le signe du dividende. Avec Number, le résultat peut aussi être -0 ; un diviseur nul produit NaN.
Les opérandes sont convertis en valeurs numériques ; ils doivent finalement être tous deux de type Number ou tous deux de type BigInt. Mélanger ces types déclenche TypeError. Si les deux opérandes sont de type BigInt, un diviseur égal à 0n déclenche RangeError. La cible doit autoriser l’écriture : affecter une valeur à une variable déclarée avec const déclenche TypeError.
L’exemple montre des restes positif et négatif ainsi que la variante BigInt. String(large) garantit un affichage uniforme du résultat, quelle que soit la façon dont la console présente les valeurs BigInt.
Exemples
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));Résultat
2 -2 2
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.