ENRU

Гайды по JSON

Обновлено

Гайды о том, на чём в JSON чаще всего спотыкаются: что такое JSON-файл и как его отформатировать, большие числа, которые меняют значение, ключи, которые меняются местами, комментарии, которых нет, одно значение на строку и YAML. В каждом — что на самом деле печатают парсеры и как получить нужный результат.

Все гайды по JSON

ГайдО чём
JSON: что это за формат и чем открыть файлЧто это за формат, что лежит в файле .json и чем его открыть: Windows, macOS, Linux, Android, iPhone, браузер или онлайн-просмотр.
Как отформатировать JSON: код, редакторы и онлайнФорматирование JSON в Python, jq, JavaScript, Go и PowerShell, в VS Code, Notepad++, IntelliJ и Sublime Text или онлайн.
Большие числа в JSON: BigInt, точность и JSON.parseПочему JSON.parse округляет 12345678901234567890 и теряет нуль в 1.10, что значит «Do not know how to serialize a BigInt» и как сохранить числа точно в JavaScript, Python, Go и Java.
Порядок ключей в JSON: почему числовые ключи встают первымиПочему JavaScript переносит числовые ключи вперёд, почему сортировка ставит "10" перед "2" и когда порядок важен.
Комментарии в JSON: можно ли, JSONC, JSON5 и обходные путиПочему в JSON нет комментариев, что разрешают JSONC и JSON5 и как оставить пометку в файле или убрать комментарии перед разбором.
JSON Lines и NDJSON: что это и как читатьОдно значение JSON на строку, почему json.load падает с «Extra data» и как читать и писать такие файлы в Python, JavaScript, Go и jq.
JSON или YAML: разница, ловушки и что выбратьСинтаксис, комментарии, якоря, «проблема Норвегии» в YAML 1.1, числа и какой формат когда выбирать.

Ошибки JSON и инструменты

Нужен разбор конкретного сообщения, например «Unexpected token» или «Expecting value»? В справочнике ошибок JSON каждая разобрана по причине, с точным текстом каждого парсера. Проверить документ прямо сейчас — в валидаторе, отформатировать — в форматировании.

Гайды по JSON: частые вопросы

Каким правилам JSON следуют гайды?

Строгому JSON по RFC 8259 — тем же правилам, что применяет валидатор. JSONC, JSON5 и JSON Lines разобраны как отдельные форматы, с тем, что каждый из них добавляет.

Почему один и тот же JSON выходит из разных инструментов по-разному?

Большинство инструментов разбирают текст в значения и печатают значения обратно. По дороге числа становятся double, объекты теряют порядок ключей, а комментарии превращаются в ошибки. Гайды показывают, где это происходит и как этого избежать.

Можно ли повторить примеры самому?

Да. У каждого примера указано, какой парсер и какой версии напечатал результат: его можно повторить в Node.js, Python, Go, Java или jq или вставить тот же JSON в форматирование и сравнить.