CKTIS / JavaScript
Przypisanie reszty z dzielenia (%=)
Operator %= oblicza resztę z dzielenia bieżącej wartości przez prawy operand i zapisuje wynik w tym samym miejscu. Obsługuje Number oraz BigInt; reszta nie jest tym samym co zawsze nieujemne modulo.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
target %= expressionOperator target %= expression odczytuje wartość celu, oblicza resztę z dzielenia przez prawy operand i przypisuje wynik do celu. Samo wyrażenie zwraca przypisaną wartość. Dla prostej zmiennej x %= y działa jak x = x % y, lecz cel po lewej stronie jest wyznaczany tylko raz — ma to znaczenie przy dostępie do właściwości z efektami ubocznymi.
% oznacza resztę, nie zawsze nieujemne modulo: -17 % 5 daje -2. Niezerowa reszta ma znak dzielnej. Dla Number możliwy jest także wynik -0; dzielnik równy zero daje NaN.
Operandy są konwertowane do wartości liczbowych; oba muszą ostatecznie być typu Number albo oba typu BigInt. Mieszanie tych typów powoduje TypeError. Jeśli oba operandy są typu BigInt, dzielnik 0n powoduje RangeError. Cel musi dopuszczać zapis: przypisanie do zmiennej zadeklarowanej przez const powoduje TypeError.
Przykład pokazuje dodatnią i ujemną resztę oraz wariant BigInt. String(large) zapewnia jednolity zapis wyniku bez zależności od sposobu prezentowania BigInt przez konsolę.
Przykłady
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));Wynik
2 -2 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.