CKTIS / JavaScript
BigInt — точни цели числа
BigInt(value) създава примитивна стойност bigint за точни целочислени изчисления извън безопасния диапазон на Number. Научете как работи преобразуването, какви ограничения важат за аритметичните операции и как се създава текст с toString(radix).
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
BigInt(value)
123n
value.toString(radix)BigInt(value) връща примитивна стойност от тип bigint, която представлява цяло число с произволна точност в рамките на ресурсните ограничения на имплементацията. Друга възможност е литерал със суфикс n, например 123n. Функцията и литералите са част от ECMAScript 2020, а не от Web APIs. new BigInt(1) хвърля TypeError. Езиковата спецификация не е таблица за съвместимост на браузърите; наличието на Node 24 в хранилище не доказва поддръжка от браузърите.
За големи стойности използвайте текст, например BigInt("9007199254740993"): преобразуването не може да отмени предишно закръгляне на стойност Number. BigInt(1.5) хвърля RangeError, а невалиден текст за цяло число хвърля SyntaxError. Преобразуването на true създава 1n, а преобразуването на false създава 0n.
Аритметичните операции изискват съвпадащи типове: 1n + 1 хвърля TypeError, докато 1n + 1n създава 2n. Целочисленото деление отрязва дробната част към нулата: 7n / 2n създава 3n. Преобразуването чрез Number(value) може да доведе до загуба на точност.
Разграничавайте името BigInt.toString от метода за стойностите: действителният API е BigInt.prototype.toString, който се извиква като value.toString(radix). BigInt.toString() описва самата функция, вместо да форматира цяло число. Методът за стойност връща текст без суфикса n; основата по подразбиране е 10. Преди проверката на диапазона методът преобразува radix в цяло число, като отрязва дробната част към нулата. Ако получената стойност е извън диапазона от 2 до 36 включително, методът хвърля RangeError. Например (255n).toString(36.9) използва основа 36 и връща "73".
Примери
const value = BigInt("9007199254740993");
const next = value + 2n;
console.log(typeof value);
console.log(next.toString());
console.log((255n).toString(16));
console.log((7n / 2n).toString());Резултат
bigint 9007199254740995 ff 3
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- ECMAScript® Language Specification
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® Language Specification — Numbers and Dates
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® 2020 Language Specification
- Official reference — developer.mozilla.org: BigInt / toString