WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Restzuweisung (%=)

Der Operator %= berechnet den Rest der aktuellen Zahl geteilt durch den rechten Operanden und speichert das Ergebnis im selben Ziel. Er unterstützt Number und BigInt; ein Rest ist nicht dasselbe wie ein stets nichtnegativer Modulo-Wert.

Version: 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 %= expression

Der Operator target %= expression liest den Wert des Ziels, berechnet den Rest nach der Division durch den rechten Operanden und weist das Ergebnis dem Ziel zu. Der Ausdruck selbst gibt den zugewiesenen Wert zurück. Bei einer einfachen Variablen funktioniert x %= y wie x = x % y, doch das linke Ziel wird nur einmal ausgewertet – das ist wichtig beim Zugriff auf Eigenschaften mit Seiteneffekten.

% bezeichnet den Rest, nicht einen stets nichtnegativen Modulo-Wert: -17 % 5 ergibt -2. Ein von null verschiedener Rest hat das Vorzeichen des Dividenden. Bei Number kann das Ergebnis auch -0 sein; ein Divisor von null ergibt NaN.

Die Operanden werden in numerische Werte umgewandelt; beide müssen letztlich entweder vom Typ Number oder beide vom Typ BigInt sein. Eine Mischung dieser Typen löst TypeError aus. Sind beide Operanden vom Typ BigInt, löst ein Divisor von 0n einen RangeError aus. Das Ziel muss beschreibbar sein: Eine Zuweisung an eine mit const deklarierte Variable löst TypeError aus.

Das Beispiel zeigt positive und negative Reste sowie die Variante mit BigInt. String(large) sorgt für eine einheitliche Ausgabe des Ergebnisses, unabhängig davon, wie die Konsole BigInt-Werte darstellt.

Beispiele

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));

Ergebnis

2
-2
2

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen