Гайды

Почему большое число округляется в JavaScript — и ID из API заканчивается нулями

Иллюстрация: длинная лента с цифрами входит в машину, а на выходе последние клетки стёрты

Сервер прислал заказ с номером 1234567890123456789. Ты сохраняешь его, а через минуту запрашиваешь по этому номеру — и получаешь «не найдено». Смотришь в консоль. Там 1234567890123456800.

Последние цифры превратились в нули. Никто их не менял. Код не падал. Ошибки нет. Это одна из самых тихих поломок в JavaScript — и у неё три типичные причины. Начнём с самой частой.

Откуда вообще берётся округление

В JavaScript обычное число — это число с плавающей точкой, 64 бита. Целые числа оно хранит точно только до 9 007 199 254 740 991. Это 2⁵³ − 1, и у него есть имя: Number.MAX_SAFE_INTEGER.

Шестнадцать цифр — и дальше точность заканчивается. Число побольше JavaScript не отвергает. Он молча берёт ближайшее, которое умеет хранить. Отсюда нули на конце.

Проверить любое число можно одной строкой:

Number.isSafeInteger(1234567890123456789)   // false — уже округлено

А такие номера встречаются чаще, чем кажется. ID сообщений в Discord, посты в X (бывший Twitter), заказы в некоторых магазинах, номера транзакций — все длиннее шестнадцати цифр.

Причина 1. JSON.parse округляет при чтении ответа

Самая частая. Сервер — на Python, Go или Java — отдаёт число точно. А response.json() в браузере превращает его в обычное число JavaScript. Округление случается в момент чтения, ещё до твоего кода.

Как проверить. Открой DevTools → вкладка Network → нужный запрос → Response. Там сырой текст ответа. Если в нём число правильное, а в console.log — с нулями, виноват разбор JSON.

Как починить. Лучший путь — получать ID строкой. Многие API так и делают специально: X отдаёт рядом с id поле id_str, Discord присылает все ID только строками. Ищи такое поле в документации. Если API твой — отдавай ID в кавычках.

Если сервер менять нельзя, современные браузеры умеют читать исходный текст числа прямо при разборе:

const data = JSON.parse(text, (key, value, context) =>
  key === 'id' ? BigInt(context.source) : value
)

Третий аргумент context.source — это кусок исходного текста. Его поддерживают Chrome 114+, Firefox 135+ и Safari 18.4+. BigInt — числа без потолка, с буквой n на конце.

Причина 2. Твой код превращает строку обратно в число

Сервер всё сделал правильно и прислал "1234567890123456789" в кавычках. А потом где-то в коде:

const id = Number(params.id)
const id = parseInt(row.id)
const id = +order.id

Любая из этих строк сводит всё к той же проблеме. Часто это делает ИИ — «на всякий случай привести к числу». Иногда TypeScript-тип id: number подталкивает к такому приведению.

Как проверить. Поищи по проекту Number(, parseInt( и унарный + рядом с полями id. Подробнее о том, как работают такие превращения, — в статье как превратить строку в число.

Как починить. Убери приведение, а тип поменяй на id: string. С ID не нужна арифметика — их только сравнивают и передают дальше. Строке этого достаточно.

Отдельный случай — PostgreSQL и Node.js. Библиотека pg намеренно отдаёт колонки типа bigint строками, именно чтобы не терять цифры. Иногда в проекте находится «исправление», которое переводит их в числа через parseInt. Если ID в базе большие — это исправление и ломает их.

Причина 3. Excel и Google Таблицы

Ты выгрузил заказы в CSV, открыл в таблице, поправил пару строк, сохранил, загрузил обратно. И половина номеров теперь заканчивается нулями.

Excel и Google Таблицы хранят в числе только 15 значащих цифр. Всё длиннее они округляют при открытии файла — ещё до того, как ты что-то тронул. Часто ещё и показывают в виде 1,23457E+18.

Как проверить. Открой тот же CSV в обычном текстовом редакторе. Если там цифры целые — их испортила таблица.

Как починить. При импорте укажи для колонки формат «Текст». В Google Таблицах — «Формат → Числа → Обычный текст» до вставки данных. А лучше вообще не гонять такие файлы через таблицу: правь ID в коде или в базе данных.

Почему BigInt не сохраняется через JSON.stringify?

Потому что JSON не знает, как его записать: JSON.stringify({ id: 10n }) выбросит «Do not know how to serialize a BigInt». Перед отправкой преврати его в строку: id.toString().

Это только в JavaScript?

В основном да. В Python целые числа не имеют предела, поэтому бэкенд на Python отдаёт номер точно — а ломается уже в браузере. Отсюда частая картина: «в базе правильно, на экране нет».

Деньги тоже так округляются?

До миллиардов — нет, до 2⁵³ целые точны. А вот копейки — другая история про дробные числа. Деньги храни в целых копейках или центах.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →