Вставьте документ — результат появится здесь
Что такое JSON
JSON (JavaScript Object Notation) — текстовый формат для обмена данными. Это пары «ключ — значение», собранные в объекты { } и списки [ ]. На нём отвечают почти все API, в нём хранят настройки и передают данные между сервером и браузером. Формат читается и человеком, и программой, за это его и любят. Строки берутся в двойные кавычки, значениями бывают число, строка, true/false, null, объект или массив. Вставьте данные в поле выше, и инструмент разберёт структуру и сразу покажет, всё ли в ней правильно.
В JSON всего шесть типов значений, и на этом язык заканчивается:
| Тип | Пример | Тонкость |
|---|---|---|
| Строка | "текст" | только двойные кавычки, одинарные это ошибка |
| Число | 42, 3.14, -1e5 | без ведущего нуля и без кавычек |
| Логическое | true, false | строчными буквами |
| Пустое | null | не Null и не NULL |
| Объект | { "a": 1 } | ключи всегда строки в кавычках |
| Массив | [1, 2, 3] | запятая после последнего элемента запрещена |
Больше половины ошибок разбора это как раз лишняя запятая в конце и одинарные кавычки, привычные по JavaScript.
Как отформатировать JSON
JSON из API обычно приходит одной строкой без пробелов, и читать такое невозможно. Форматирование (его же называют beautify или «сделать красивый JSON») расставляет отступы и переносы строк, и структура становится наглядной: видно вложенность, где заканчивается объект, где начинается массив. Вставьте данные и откройте вкладку с читаемым видом, размер отступа в 2 или 4 пробела либо таб переключается в настройках. Обратная операция, сжатие (minify), убирает все лишние пробелы, чтобы уменьшить объём перед отправкой на сервер.
Как проверить JSON на ошибки
Один лишний символ ломает весь файл, а приложение падает с невнятной ошибкой. Инструмент проверяет JSON на валидность и показывает строку и колонку, где споткнулся разбор. Самые частые причины: лишняя запятая после последнего элемента, одинарные кавычки вместо двойных, ключ без кавычек, незакрытая скобка и комментарии, которых в стандартном JSON нет. Проверьте данные здесь до того, как они уйдут в код. Так ошибку видно сразу, а не по логам продакшена. Если же ошибка не в самих данных, а в окружающем коде, который их обрабатывает, для этого есть проверка синтаксиса JavaScript.
JSON и YAML: в чём разница
YAML — тот же набор данных, но записанный отступами вместо скобок. Он читается легче и допускает комментарии, поэтому в нём удобно держать конфиги. JSON строже и компактнее, им передают данные между программами. Инструмент переводит в обе стороны: вставьте JSON и откройте вкладку YAML или наоборот, формат распознается сам, а результат можно скопировать или скачать.
Разбор синтаксиса с примерами, что такое ключи, массивы и вложенность и чем JSON отличается от XML, есть в статье Что такое JSON: формат данных простыми словами.