Форматировать JSON

Что переживает разбор и повторную печать

Форматирование — это разбор и повторная печать, и только числа переносятся как текст, который вы набрали. Это шире, чем случай с большими целыми, который считает баннер: любое число, чья кратчайшая запись в JavaScript отличается от вашей, выводится из исходного текста, поэтому 1.10 сохраняет конечный ноль, 1e5 остаётся в экспоненциальной форме, а отрицательный ноль остаётся отрицательным. В предупреждении считаются только небезопасные целые числа, потому что для них альтернатива — тихая порча данных, а не просто аккуратная запись.

Строки как текст не переносятся. Escape-последовательности декодируются при чтении документа и записываются заново при печати, поэтому \u0041 возвращается как A, а экранированная косая черта — без экранирования. Значение то же, а байты — нет, и это важно только в одной ситуации, но там очень важно: если что-то дальше по цепочке сравнивает два JSON-файла побайтно, прогон одного из них через форматтер не проходит бесследно.

Два поведения на уровне объектов стоит знать, прежде чем доверять переформатированию. Дубликаты ключей разрешаются молча, побеждает последний — ровно так же, как это делает собственный парсер браузера: документ с двумя полями "id" форматируется без замечаний и возвращается с одним, и ничто не сообщает, что было второе. А порядок ключей совпадает с порядком в вашем файле только для ключей, которые не являются целыми числами: объект с ключами "1", "2" и "name" вернётся с цифровыми ключами впереди, в порядке возрастания, потому что именно так JavaScript упорядочивает свойства объектов. Обычные ключи сохраняют порядок, в котором вы их написали.

Если нужно другое

Если у вас tsconfig.json, конфиг ESLint или файл настроек VS Code, эта страница укажет на комментарии и висячие запятые, а не отформатирует в обход них, — и для JSON-инструмента это правильный ответ, но для вашего файла это не тот инструмент. Это JSONC, и ваш редактор уже умеет его разбирать; в командной строке json5 и dasel читают такие файлы, не выдавая их за JSON.

Для всего, что сложнее смены отступов, форматтер — инструмент не той формы. jq одним выражением делает то, для чего в поле вставки нет никаких настроек: jq -S . сортирует ключи каждого объекта, чтобы можно было сравнить два ответа, jq 'del(.token)' удаляет поле, прежде чем показывать тело запроса кому-то, а jq -c сворачивает массив объектов в JSON Lines, которого ждёт конвейер. К тому же он читает файл, а не буфер обмена, — и это решает, когда документ больше, чем удобно выделить мышью.