CKTIS / JavaScript
Resttoewijzing (%=)
De operator %= berekent de rest van de deling van de huidige waarde door de rechteroperand en slaat het resultaat op in hetzelfde doel. De operator ondersteunt Number en BigInt; een rest is niet hetzelfde als een modulo die altijd niet-negatief is.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
target %= expressionDe operator target %= expression leest de waarde van het doel, berekent de rest na deling door de rechteroperand en wijst het resultaat toe aan het doel. De expressie zelf geeft de toegewezen waarde terug. Voor een eenvoudige variabele werkt x %= y als x = x % y, maar het doel aan de linkerkant wordt maar één keer geëvalueerd. Dat is belangrijk bij toegang tot eigenschappen met neveneffecten.
% betekent rest, niet een modulo die altijd niet-negatief is: -17 % 5 geeft -2. Een rest die niet nul is, heeft het teken van het deeltal. Bij Number kan het resultaat ook -0 zijn; een deler van nul geeft NaN.
De operanden worden omgezet naar numerieke waarden; uiteindelijk moeten ze allebei van het type Number of allebei van het type BigInt zijn. Het mengen van deze typen veroorzaakt TypeError. Als beide operanden van het type BigInt zijn, veroorzaakt een deler van 0n een RangeError. Het doel moet beschrijfbaar zijn: toewijzen aan een variabele die met const is gedeclareerd veroorzaakt TypeError.
Het voorbeeld laat positieve en negatieve resten zien, evenals de variant met BigInt. String(large) zorgt voor een consistente resultaatnotatie, ongeacht hoe de console BigInt-waarden weergeeft.
Voorbeelden
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));Resultaat
2 -2 2
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.