BigInt vs обычные числа
На этой странице
BigInt нужен для целых чисел больше безопасного диапазона Number. В JavaScript нет отдельного типа int: обычные числа имеют тип number, а большие целые - bigint.
Вопрос
Что делает BigInt и зачем он нужен? В чем разница от обычного числа?
Обычный number
Все обычные числа в JavaScript имеют тип number.
typeof 10; // "number"
typeof 3.14; // "number"number основан на формате IEEE 754 double precision. Он хранит и целые, и дробные числа.
Проблема: не все большие целые числа можно представить точно.
Number.MAX_SAFE_INTEGER; // 9007199254740991После этого предела точность ломается:
9007199254740991 + 1; // 9007199254740992
9007199254740991 + 2; // 9007199254740992BigInt
BigInt хранит целые числа произвольной длины.
const id = 9007199254740993n;
typeof id; // "bigint"Создать можно через суффикс n или функцию BigInt().
const a = 10n;
const b = BigInt("9007199254740993");Арифметика
10n + 5n; // 15n
10n * 2n; // 20nНо нельзя смешивать bigint и number в арифметике:
10n + 5; // TypeErrorНужно привести явно:
10n + BigInt(5); // 15n
Number(10n) + 5; // 15Второй вариант может потерять точность для больших значений.
Деление
BigInt работает только с целыми числами.
5n / 2n; // 2nДробная часть отбрасывается.
Когда использовать
BigInt полезен для:
- больших id;
- криптографии;
- точной целочисленной арифметики;
- счетчиков, которые могут выйти за
Number.MAX_SAFE_INTEGER.
Для обычных цен, размеров, координат и большинства UI-расчетов обычно хватает number.
JSON и BigInt
JSON.stringify не умеет сериализовать bigint напрямую.
JSON.stringify({ id: 10n }); // TypeErrorЧасто BigInt передают как строку:
JSON.stringify({ id: String(10n) }); // '{"id":"10"}'Что важно помнить
BigIntнельзя смешивать сnumberв арифметике:1n + 1—TypeError.- Деление
BigIntотбрасывает дробную часть:7n / 2n→3n. JSON.stringifyне поддерживаетBigInt— нуженtoJSONили replacer.- Используйте
BigIntдля идентификаторов из БД больше2^53и точной целочисленной арифметики, а не для денег с копейками.
Мини-шпаргалка
| Значение | Тип |
|---|---|
10 | number |
10n | bigint |
Number.MAX_SAFE_INTEGER | максимальное безопасное целое |
10n + 5 | TypeError |
5n / 2n | 2n |