CKTIS / JavaScript
Restwertoperator (%)
Der Operator % berechnet den Rest für Werte vom Typ Number oder BigInt. Ein Ergebnis ungleich null hat das Vorzeichen des Dividenden; bei negativen Zahlen unterscheidet sich der Rest daher vom nichtnegativen Modulo. Operandentypen und Division durch null erfordern besondere Aufmerksamkeit.
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
dividend % divisorIm Ausdruck dividend % divisor ist der linke Operand der Dividend und der rechte der Divisor. Bei endlichen Werten und einem Divisor ungleich null entspricht der Rest dem Ergebnis, wenn man vom Dividenden den Divisor multipliziert mit dem in Richtung null abgeschnittenen Quotienten abzieht. Ein Ergebnis ungleich null hat das Vorzeichen des Dividenden: -13 % 5 ergibt -3, während 13 % -5 3 ergibt. % bedeutet nicht Prozent.
Der Rest ist nicht dasselbe wie ein nichtnegativer Modulo-Wert. Für ganzzahlige Number-Werte im sicheren Bereich und einen positiven Divisor lässt sich das Ergebnis mit ((dividend % divisor) + divisor) % divisor normalisieren; berücksichtige auch den sicheren Bereich der Zwischensumme. Für -13 und 5 ergibt das 2.
Operanden werden in numerische Werte umgewandelt; danach müssen beide vom Typ Number oder beide vom Typ BigInt sein. Eine Mischung dieser Typen löst einen TypeError aus. Number erlaubt Brüche, zum Beispiel ergibt 5.5 % 2 den Wert 1.5, unterliegt aber Einschränkungen der Gleitkommagenauigkeit. BigInt arbeitet mit Ganzzahlen.
Bei Number ergibt ein Divisor von 0 oder -0, ein NaN-Operand oder ein unendlicher Dividend NaN. Ein endlicher Dividend mit unendlichem Divisor bleibt unverändert. Ein negativer Dividend kann -0 ergeben, erkennbar mit Object.is(result, -0). Bei BigInt löst ein Divisor von 0n einen RangeError aus; dieser Typ kennt kein -0.
% hat dieselbe Priorität wie * und / und eine höhere als + und -; Operatoren dieser Gruppe werden von links nach rechts ausgewertet. Der Operator gehört zur ECMAScript-Sprache und ist keine Web-API. Das Beispiel erfordert eine Umgebung mit BigInt.
Beispiele
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));Ergebnis
-3 2 1.5 3 true true
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.