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

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

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

Източници