База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Оператор за остатък (%)

Операторът % изчислява остатък за стойности от тип Number или BigInt. Ненулевият резултат има знака на делимото, затова при отрицателни числа остатъкът се различава от неотрицателното modulo. Трябва да се внимава с типовете на операндите и делението на нула.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

dividend % divisor

В израза dividend % divisor левият операнд е делимото, а десният е делителят. При крайни стойности и делител, различен от нула, остатъкът съответства на изваждането от делимото на произведението на делителя и частното, отсечено към нула. Ненулевият резултат има знака на делимото: -13 % 5 е -3, а 13 % -5 е 3. % не означава процент.

Остатъкът не е същото като неотрицателно modulo. За целочислени стойности Number в безопасния диапазон и положителен делител резултатът може да се нормализира с ((dividend % divisor) + divisor) % divisor; вземете предвид и безопасния диапазон на междинната сума. За -13 и 5 резултатът е 2.

Операндите се преобразуват в числови стойности; след преобразуването и двата трябва да са от тип Number или и двата от тип BigInt. Смесването на тези типове поражда TypeError. Number допуска дроби, например 5.5 % 2 е 1.5, но е подложен на ограниченията в точността на числата с плаваща запетая. BigInt работи с цели числа.

При Number делител 0 или -0, операнд NaN или безкрайно делимо дава NaN. Крайно делимо с безкраен делител остава непроменено. Отрицателното делимо може да даде -0, което се открива с Object.is(result, -0). При BigInt делител 0n поражда RangeError; този тип няма -0.

% има същия приоритет като * и /, по-висок от този на + и -; операторите от тази група се свързват отляво надясно. Той е част от езика ECMAScript, а не от Web API. Примерът изисква среда с поддръжка на BigInt.

Примери

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

Резултат

-3
2
1.5
3
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници